Okto Web3 MCP Server

Okto Web3 MCP Server

site icon
2025.03.21 0
JavaScriptWeb3服务区块链管理加密资产管理金融服务
Okto Web3 MCP Server 是一个为Claude Desktop设计的模型上下文协议(MCP)服务器,专注于Web3集成和自动化认证支持。它使AI助手能够通过自然语言交互管理Web3交易和投资组合。该服务器支持查看投资组合详情、账户信息、NFT收藏、交易历史,以及代币转账等功能,适用于需要与区块链网络交互的场景。
View on GitHub

Overview

基本能力

产品定位

Okto Web3 MCP Server 是一个专为Web3交互设计的服务器,旨在通过自然语言处理简化区块链交易和资产管理。

核心功能

  • 查看投资组合详情,包括持仓和余额
  • 获取跨链账户信息
  • 查看NFT收藏和投资组合
  • 检查交易历史
  • 代币转账
  • 支持多区块链网络
  • 查看支持的链和代币
  • 简单的OAuth2认证流程,支持自动浏览器启动
  • 支持桌面和Web应用凭证
  • 全局凭证存储

适用场景

  • 通过AI助手管理加密资产
  • 自动化Web3交易流程
  • 跨链资产管理和查询
  • NFT收藏管理

工具列表

  1. Get Portfolio (get-portfolio): 检索包括持仓和余额在内的详细投资组合信息
  2. Get Account (get-account): 检索跨链账户详情
  3. Get NFT Collections (get-nft-collections): 列出与账户关联的所有NFT收藏
  4. Get Orders History (get-orders-history): 检索交易历史
  5. Get NFT Portfolio (get-nft-portfolio): 显示详细的NFT持仓信息
  6. Get Tokens (get-tokens): 列出所有可用代币及其详情
  7. Token Transfer (token-transfer): 在地址间转账代币
  8. Get Chains (get-chains): 列出所有支持的区块链网络

常见问题解答

  1. OAuth Keys Not Found: 确保gcp-oauth.keys.json在当前目录或~/.okto-mcp/
  2. Invalid Credentials Format: 确保OAuth密钥文件包含webinstalled凭证
  3. Port Already in Use: 如果端口3000已被占用,请释放后再运行认证
  4. Okto Authentication Failed: 验证环境变量设置是否正确,检查Okto凭证是否有效

使用教程

使用依赖

  1. 创建Google Cloud项目并获取凭证
  2. 设置Okto凭证

安装教程

  1. 手动安装: bash mkdir -p ~/.okto-mcp mv gcp-oauth.keys.json ~/.okto-mcp/ npx @okto_web3/okto-mcp-server@latest auth

  2. Claude Desktop配置: 在Claude Desktop配置文件中添加以下内容: 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" ] } } }

调试方式

  1. 运行认证命令后,检查~/.okto-mcp/credentials.json是否生成
  2. 验证环境变量是否正确设置
  3. 检查端口3000是否可用

许可证

该项目遵循 ISC 开源许可条款。