Coin MCP 服务器

一个提供访问CoinMarketCap加密货币数据的模型上下文协议（Model Context Protocol）服务器。此服务器使AI驱动的应用程序能够检索加密货币列表、报价和各种代币的详细信息。

可用工具

• listing-coins - 获取所有活跃加密货币的分页列表及其最新的市场数据。

  • start (整数，可选)：分页列表结果的起始位置（1-based索引）。
  • limit (整数，可选)：要返回的结果数量（默认：10，最大：5000）。
  • price_min (数字，可选)：用于过滤结果的最低USD价格。
  • price_max (数字，可选)：用于过滤结果的最高USD价格。
  • market_cap_min (数字，可选)：用于过滤结果的最低市值。
  • market_cap_max (数字，可选)：用于过滤结果的最高市值。
  • convert (字符串，可选)：计算多个货币的市场报价。
  • sort (字符串，可选)：按字段对加密货币进行排序。
  • sort_dir (字符串，可选)：对加密货币排序的方向（asc 或 desc）。

• get-coin-info - 检索特定加密货币的详细信息。

  • id (字符串，可选)：一个或多个CoinMarketCap加密货币ID，以逗号分隔。
  • slug (字符串，可选)：以逗号分隔的加密货币别名列表。
  • symbol (字符串，可选)：一个或多个加密货币符号，以逗号分隔。

• get-coin-quotes - 获取一种或多种加密货币的最新市场报价。

  • id (字符串，可选)：一个或多个CoinMarketCap加密货币ID，以逗号分隔。
  • slug (字符串，可选)：以逗号分隔的加密货币别名列表。
  • symbol (字符串，可选)：一个或多个加密货币符号，以逗号分隔。

安装

通过Smithery安装

要自动为Claude Desktop安装CoinMarketCap数据，请使用Smithery：

npx -y @smithery/cli install coin-api-mcp --client claude

构建服务器

克隆此仓库并使用默认的Python解释器构建和安装程序：

git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

安装完成后，可以使用以下命令运行它作为脚本：

python -m coin_api_mcp

配置

API密钥

服务器需要CoinMarketCap API密钥才能运行。可以通过两种方式提供API密钥：

1. 作为环境变量：

export COINMARKETCAP_API_KEY=your_api_key_here

2. 作为命令行参数：

python -m coin_api_mcp --api-key your_api_key_here

在Claude.app中的设置

要在Claude.app中配置，请将以下内容添加到config.json：

{
    "coinMcp": {
        "apiKey": "your_api_key_here",
        "serverUrl": "http://localhost:5000"
    }
}

调试

调试信息可以使用日志记录工具进行查看，例如：

python -m coin_api_mcp --debug

贡献指南

欢迎贡献！请访问GitHub仓库了解更多信息，并找到如何参与的资源。

许可证

该项目遵守MIT License。查看LICENSE获取详细信息。