🚀 Okto Web3 MCP 服务器
Okto Web3 MCP 服务器是一个用于 Okto Web3 整合的模型上下文协议（MCP）服务器，专为 Claude 桌面应用打造，还具备自动身份验证功能。借助该服务器，AI 助手能够通过自然语言交互，轻松管理 Web3 交易和资产组合。
🚀 快速开始
Okto Web3 MCP 服务器能让 AI 助手借助自然语言交互管理 Web3 交易和资产组合。你可以按以下步骤完成安装与配置：
- 准备好 OAuth 凭证并完成环境变量配置。
- 运行认证脚本获取访问令牌。
- 在 Claude 桌面应用中添加相应配置。
✨ 主要特性
- 查看资产组合详情，涵盖持仓和余额等信息。
- 获取多条链上的账户信息。
- 列出与账户关联的所有 NFT 收藏品。
- 检视交易历史记录。
- 查看详细的 NFT 持仓信息。
- 列出所有可用代币及其细节。
- 转移代币至指定地址。
- 获取所有支持的区块链网络列表。
📦 安装指南
1. OAuth 凭证准备
- 确保拥有有效的 Google OAuth 2.0 凭证文件
gcp-oauth.keys.json。 - 将其置于当前目录或用户主目录下的
.okto-mcp文件夹中。
2. 环境变量配置
export OKTO_ENV=development # 或 production
3. 身份验证流程
- 运行认证脚本以获取访问令牌。
- 脚本将自动处理凭证文件并建立安全的授权会话。
📚 详细文档
Claude 桌面应用配置
在 ~/.config/claude/web3.json 中添加以下配置：
{
"mcp-server": {
"url": "http://localhost:3000",
"auth": {
"type": "okto",
"env": "${OKTO_ENV}"
}
}
}
可用工具
1. 资产组合详情查询
{
"examples": ["查询所有链上的资产情况"]
}
2. 多链账户信息获取
{}
3. NFT 收藏品列表
{}
4. 交易历史记录
{}
5. NFT 资产组合详情
{}
6. 可用代币列表
{}
7. 代币转移操作
指定转账参数：
{
"amount": "1000000000000000000",
"recipient": "0x...",
"token": "0x...",
"caip2Id": "eip155:1"
}
8. 支持链路列表
{}
安全须知
- OAuth 凭证安全存储于本地环境 (
~/.okto-mcp)。 - 服务器采用离线访问模式以维持持久认证状态。
- 切勿共享或提交凭证到版本控制系统中。
- 定期检查并吊销未使用的 Google 账户权限。
- Okto 凭证应通过环境变量安全存储。
- 凭证对当前用户仅限访问。
故障排除
1. OAuth 密钥未找到
- 确保
gcp-oauth.keys.json文件存在于当前目录或~/.okto-mcp/。 - 核查文件权限设置。
2. 凭证格式无效
- 确认 OAuth 凭证文件包含有效
web或installed类型配置。 - 对于 web 应用，核实重定向 URI 配置正确。
3. 端口已被占用
- 若端口 3000 被占用，请释放该端口后再运行认证流程。
- 可使用命令查找并终止占用进程。
4. Okto 认证失败
- 检查环境变量配置是否正确。
- 确认 Okto 凭证有效无误。
- 确保使用正确的环境（测试/生产）。
📄 许可证
ISC
支持与反馈
如遇问题或有任何疑问，请在 GitHub 仓库中提交 ISSUE。