Okto MCP Server

🚀 Okto Web3 MCP 服务器

Okto Web3 MCP 服务器是一个用于 Okto Web3 整合的模型上下文协议（MCP）服务器，专为 Claude 桌面应用打造，还具备自动身份验证功能。借助该服务器，AI 助手能够通过自然语言交互，轻松管理 Web3 交易和资产组合。

🚀 快速开始

Okto Web3 MCP 服务器能让 AI 助手借助自然语言交互管理 Web3 交易和资产组合。你可以按以下步骤完成安装与配置：

1. 准备好 OAuth 凭证并完成环境变量配置。
2. 运行认证脚本获取访问令牌。
3. 在 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。