THORChain MCP Server

mcp胸链

提供对THORChain区块链数据访问的模型上下文协议（MCP）服务器。该服务器使Claude等AI助手能够通过标准化的接口查询THORChain交易、池、网络统计数据和保险库地址。

特性

• 交易查询：获取特定THORChain交易的详细信息
• 地址历史记录：查询任何区块链地址的交易历史
• 池统计：访问流动性池数据，包括价格、APY和交易量
• 游泳池详细信息：获取特定流动性池的深入信息
• 网络统计：检索网络范围内的统计数据，包括交换量和活动用户
• 保险库地址：获取当前用于向THORChain存款的入站地址

需求

• Node.js>=20.0.0
• npm或兼容的包管理器

安装

来自npm（推荐）

npm install -g @missionsquad/mcp-thorchain

来自源头

# Clone the repository
git clone https://github.com/MissionSquad/mcp-thorchain.git
cd mcp-thorchain

# Install dependencies
npm install

# Build the project
npm run build

配置

克劳德桌面

要将此MCP服务器与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "thorchain": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-thorchain/dist/index.js"
      ]
    }
  }
}

替换 /absolute/path/to/mcp-thorchain 带有安装目录的实际路径。

添加配置后：

1. 完全退出Claude Desktop（macOS上的Cmd+Q，或Windows上的系统托盘）
2. 重新打开克劳德桌面
3. THORChain工具现在应该可用了

MCP检验员测试

您可以使用MCP检查器在没有Claude Desktop的情况下测试服务器：

npx @modelcontextprotocol/inspector node dist/index.js

这将打开一个web界面（通常在 http://localhost:5173)您可以在哪里：

• 查看所有可用工具
• 使用自定义参数执行测试工具
• 查看请求/响应数据
• 调试服务器行为

可用工具

1. get-transaction

获取特定THORChain交易的详细信息。

参数：

• txid （字符串，必填）：事务哈希（64个字符的十六进制字符串）

例子：

{
  "txid": "DC85CB537CB6082F61270D70C4058BB111475BCDC403E6E42AAF2106D067E1B4"
}

2. get-address-history

检索区块链地址的交易历史记录。

参数：

• address （字符串，必填）：要查询的区块链地址
• limit （数字，可选）：要返回的最大交易量（默认值：10，最大值：50）
• offset （数字，可选）：分页偏移量（默认值：0）

例子：

{
  "address": "thor1...",
  "limit": 20,
  "offset": 0
}

3. get-pools

获取所有THORChain流动性池的统计数据。

参数：

• period （枚举，可选）：时间段-“1h”|“24h”|“7d”|“30d”|“90d”|“365d”|“全部”（默认：“24h”）

例子：

{
  "period": "24h"
}

4. get-pool-detail

获取特定流动性池的详细信息。

参数：

• asset （字符串，必填）：池资产标识符（例如“BTC.BTC”、“ETH.ETH”）

例子：

{
  "asset": "BTC.BTC"
}

5. get-network-stats

获取THORChain网络的整体统计数据。

参数： 无

6. get-vault-addresses

获取当前THORChain金库地址以存入资金。

参数： 无

API提供商

服务器自动在多个API提供程序之间轮换以实现冗余：

主要的，重要的：九个领域(https://midgard.ninerealms.com, https://thornode.ninerealms.com) 后备方案：液化(https://midgard.thorchain.liquify.com, https://thornode.thorchain.liquify.com)

如果主提供程序失败或超时，服务器会自动尝试回退提供程序。

发展

构建

npm run build

观看模式

npm run watch

项目结构

mcp-thorchain/
 src/
    index.ts           # MCP server and tool definitions
    api-client.ts      # THORChain API client with provider rotation
    types.ts           # TypeScript type definitions
 dist/                  # Compiled JavaScript output
 package.json
 tsconfig.json
 README.md

技术细节

依赖项

• @modelcontextprotocol/sdk@1.22.0：MCP服务器SDK
• zod@3.23.8：架构验证

类型安全

该项目使用启用严格模式的TypeScript。由于Zod v3.23.8（与MCP SDK捆绑在一起）和TypeScript的类型推断之间存在已知的不兼容性，主服务器文件使用 @ts-nocheck运行时验证和类型安全是通过Zod模式维护的。

错误处理

• 所有API请求都包含5秒超时
• 连接错误时自动提供程序故障转移
• 带有上下文的全面错误消息
• 自定义 THORChainAPIError 用于特定于API的错误的类

故障排除

工具未出现在Claude中

1. 验证中的路径 claude_desktop_config.json 绝对正确
2. 确保项目建成(npm run build)
3. 完全退出并重新启动Claude Desktop
4. 查看克劳德的日志：

- macOS： ~/Library/Logs/Claude/mcp-server-thorchain.log - 窗户： %APPDATA%\Claude\logs

构建错误

如果在更新依赖关系后遇到构建错误：

# Clean and rebuild
rm -rf dist node_modules package-lock.json
npm install
npm run build

连接超时

对于每个API请求，服务器都有5秒的超时时间。如果您经常超时：

1. 检查您的互联网连接
2. 验证API提供程序是否正常运行
3. 服务器将自动尝试回退提供程序

api参考

有关THORChain API的详细文档，请参阅 THORChain API手册.

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

链接

• 模型上下文协议
• THORChain文档
• 九境界API