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. 全局身份验证（推荐）：

   # 首次：将 gcp-oauth.keys.json 放置在您主目录的 .okto-mcp 文件夹中
   mkdir -p ~/.okto-mcp
   mv gcp-oauth.keys.json ~/.okto-mcp/
   
   # 从任何地方运行身份验证
   npx @okto_web3/okto-mcp-server@latest auth
   

   b. 本地身份验证：

   # 将 gcp-oauth.keys.json 放置在您当前目录中
   # 该文件将自动复制到全局配置
   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)

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

<!-- ```json {}

### 2. 获取账户 (`get-account`)
检索跨多个链的账户详细信息。

<!-- ```json
{}
``` -->

### 3. 获取 NFT 收藏 (`get-nft-collections`)
列出与该账户关联的所有 NFT 收藏。
<!--
```json
{}
``` -->

### 4. 获取订单历史 (`get-orders-history`)
检索交易历史。

<!-- ```json
{}
``` -->

### 5. 获取 NFT 投资组合 (`get-nft-portfolio`)
显示详细的 NFT 持仓信息。

<!-- ```json
{}
``` -->

### 6. 获取代币 (`get-tokens`)
列出所有可用的代币及其详细信息。

<!-- ```json
{}
``` -->

### 7. 代币转移 (`token-transfer`)
在地址之间转移代币。

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

8. 获取链 (get-chains)

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

<!-- ```json {}

## 安全注意事项

- 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。