Okto Web3 MCP Server

Okto Web3 MCP 服务

一个用于在 Claude Desktop 中集成 Okto Web3 并支持自动身份验证的模型上下文协议（MCP）服务。此服务可让 AI 助手通过自然语言交互管理 Web3 交易和投资组合。

功能

• 查看投资组合详情，包括持仓和余额
• 获取多个链上的账户信息
• 查看 NFT 收藏集和投资组合
• 查看交易历史记录
• 在地址之间转移代币
• 支持多个区块链网络
• 查看支持的链和代币
• 简单的 OAuth2 身份验证流程，并自动启动浏览器
• 支持桌面应用和 Web 应用凭据
• 便于使用的全局凭据存储

安装与身份验证

手动安装

1. 创建 Google Cloud 项目并获取凭据：

   a. 创建 Google Cloud 项目：

   • 前往 Google Cloud Console
   • 创建新项目或选择现有项目
   • 为项目启用所需的 OAuth 范围

   b. 创建 OAuth 2.0 凭据：

   • 前往“API 和服务” > “凭据”
   • 点击“创建凭据” > “OAuth 客户端 ID”
   • 选择“桌面应用”或“Web 应用”作为应用类型
   • 为其命名并点击“创建”
   • 对于 Web 应用，将 http://localhost:3000/oauth2callback 添加到已授权的重定向 URI
   • 下载客户端 OAuth 密钥的 JSON 文件
   • 将密钥文件重命名为 gcp-oauth.keys.json

2. 设置 Okto 凭据：

   从 https://dashboard.okto.tech/ 获取以下 Okto 凭据：

   OKTO_ENVIRONMENT=sandbox
   OKTO_CLIENT_PRIVATE_KEY=your_private_key
   OKTO_CLIENT_SWA=your_swa
   

3. 运行身份验证：

   你可以通过两种方式进行身份验证：

   a. 全局身份验证（推荐）：

   # First time: Place gcp-oauth.keys.json in your home directory's .okto-mcp folder
   mkdir -p ~/.okto-mcp
   mv gcp-oauth.keys.json ~/.okto-mcp/
   
   # Run authentication from anywhere
   npx @okto_web3/okto-mcp-server@latest auth
   

   b. 本地身份验证：

   # Place gcp-oauth.keys.json in your current directory
   # The file will be automatically copied to global config
   npx @okto_web3/okto-mcp-server@latest auth
   

   身份验证流程将：

   • 在当前目录或 ~/.okto-mcp/ 中查找 gcp-oauth.keys.json
   • 如果文件位于当前目录，则将其复制到 ~/.okto-mcp/
   • 打开默认浏览器以进行 Google 身份验证
   • 将凭据保存为 ~/.okto-mcp/credentials.json

   注意：

   • 成功完成身份验证后，凭据会全局存储在 ~/.okto-mcp/ 中，可从任何目录使用
   • 支持桌面应用和 Web 应用凭据
   • 对于 Web 应用凭据，请确保将 http://localhost:3000/oauth2callback 添加到已授权的重定向 URI

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件中（在 macOS 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "okto": {
      "command": "node",
      "env": {
        "OKTO_ENVIRONMENT": "sandbox",
        "OKTO_CLIENT_PRIVATE_KEY": "your_private_key_here",
        "OKTO_CLIENT_SWA": "your_swa_here"
      },
      "args": [
        "/path/to/okto-mcp-server/build/index.js"
      ]
    }
  }
}

替换：

• 将 your_private_key_here 替换为你的 Okto 客户端私钥
• 将 your_swa_here 替换为你的 Okto 客户端 SWA
• 将 /path/to/okto-mcp-server 替换为安装服务的实际路径

或者，如果你通过 npm 安装：

{
  "mcpServers": {
    "okto": {
      "command": "npx",
      "env": {
        "OKTO_ENVIRONMENT": "sandbox",
        "OKTO_CLIENT_PRIVATE_KEY": "your_private_key_here",
        "OKTO_CLIENT_SWA": "your_swa_here"
      },
      "args": [
        "@okto_web3/okto-mcp-server@latest"
      ]
    }
  }
}

可用工具

该服务提供以下工具，可通过 Claude Desktop 使用：

1. 获取投资组合（get-portfolio）

获取详细的投资组合信息，包括持仓和余额。

2. 获取账户（get-account）

获取多个链上的账户详情。

3. 获取 NFT 收藏集（get-nft-collections）

列出与账户关联的所有 NFT 收藏集。

4. 获取订单历史记录（get-orders-history）

获取交易历史记录。

5. 获取 NFT 投资组合（get-nft-portfolio）

显示详细的 NFT 持仓信息。

6. 获取代币（get-tokens）

列出所有可用代币及其详情。

7. 代币转账（token-transfer）

在地址之间转移代币。

{
  "amount": "1000000000000000000",
  "recipient": "0x...",
  "token": "0x...",
  "caip2Id": "eip155:1"
}

8. 获取链（get-chains）

列出所有支持的区块链网络。

安全说明

• OAuth 凭据会安全地存储在本地环境中（~/.okto-mcp/）
• 服务会使用离线访问来维持持久身份验证
• 切勿分享凭据，也不要将其提交到版本控制系统
• 定期在 Google 账号设置中检查并撤销不再使用的访问权限
• Okto 凭据应安全地存储在环境变量中
• 凭据会全局存储，但只有当前用户可以访问

故障排除

1. 未找到 OAuth 密钥

   • 确保 gcp-oauth.keys.json 位于当前目录或 ~/.okto-mcp/ 中
   • 检查文件权限

2. 凭据格式无效

   • 确保 OAuth 密钥文件包含 web 或 installed 凭据
   • 对于 Web 应用，请确认重定向 URI 配置正确

3. 端口已被占用

   • 如果端口 3000 已被占用，请在运行身份验证前释放该端口
   • 你可以查找并停止占用该端口的进程

4. Okto 身份验证失败

   • 确认环境变量设置正确
   • 检查 Okto 凭据是否有效
   • 确保使用了正确的环境（sandbox/production）

许可证

ISC

支持

如果遇到问题或有疑问，请在 GitHub 仓库中提交 issue。