Mantle收益MCP服务器

一个通用的MCP服务器,用于处理Mantle收益数据,提供多种API功能包括健康状态检查、机会列表、详细机会信息和图表数据。

  • by Urazanev
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Urazanev/mantle-yield-mcp

使用说明

地幔屈服MCP

用于Mantle产量数据的通用MCP服务器,由位于 https://mantle-yield.asterworks.cc.

它旨在与任何可以通过以下方式启动本地进程的MCP客户端配合使用 stdio,包括终端代理和基于编辑器的MCP主机。

它提供了什么

  • mantle_get_health --后端运行状况
  • mantle_get_summary --仪表板摘要
  • mantle_list_opportunities --使用筛选器、排序和分页列出商机
  • mantle_get_opportunity --单个机会的完整细节
  • mantle_get_opportunity_chart --一个机会的APY/TVL图表数据
  • mantle_compare_opportunities --2-3个机会的并排比较
  • mantle_refresh_data --触发后端刷新

需求

  • Node.js >= 22
  • npm

安装

git clone https://github.com/Urazanev/mantle-yield-mcp.git
cd mantle-yield-mcp
npm install
npm run build

不 .env 默认设置需要文件。

在本地运行

npm start

如果进程保持打开状态,则服务器正在等待MCP客户端 stdin / stdout.

通用MCP设置

大多数MCP客户端最终都需要相同的运行时信息:

  • 可执行命令
  • 指向已构建服务器入口点的绝对路径
  • 可选环境变量

在MCP客户端配置中使用此运行时形状,仅使外部JSON结构适应您的客户端:

{
  "name": "mantle-yield",
  "type": "stdio",
  "command": "node",
  "args": [
    "/ABSOLUTE/PATH/TO/mantle-yield-mcp/dist/index.js"
  ]
}

替换 /ABSOLUTE/PATH/TO/mantle-yield-mcp/dist/index.js 在你的机器上有真正的绝对路径。

集成说明

  • 使用绝对路径 dist/index.js.
  • 更喜欢发射 node 直接。
  • 不要使用 npm start, npx,或将其他包装器作为MCP命令,因为包装器输出可能会破坏MCP握手。
  • 服务器支持MCP主机使用的两种常见本地stdio帧样式:
    • Content-Length 框架JSON-RPC
    • 以换行符分隔的JSON-RPC

环境变量

所有环境变量都是可选的。

变量 默认值 描述
MANTLE_YIELD_API_BASE_URL https://mantle-yield.asterworks.cc 覆盖后端API基础URL
MANTLE_YIELD_API_TOKEN unset 可选承载令牌
MANTLE_YIELD_API_TIMEOUT_MS 10000 HTTP超时(毫秒)

发展

npm run dev

或

npm run dev:tsx

故障排除

  • 代码更改后重建: npm run build
  • 如果客户挂断 initialize,验证它是否启动 node /absolute/path/to/dist/index.js 直接

备注

  • 仅使用Mantle Yield后端API作为其数据源
  • 不直接呼叫DefiLama
  • 不解析HTML或读取本地快照文件
  • 不执行链上交易