Coin MCP 服务器

一个模型上下文协议 (Model Context Protocol) 服务器，提供对 CoinMarketCap 加密货币数据的访问。该服务器使 AI 驱动的应用程序能够检索加密货币列表、报价以及有关各种币种的详细信息。

可用工具

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

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

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

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

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

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装加密货币数据：

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 密钥才能运行。您可以从 CoinMarketCap 的网站 获取一个。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 设置：

<details> <summary>使用 pip 安装</summary>

"mcpServers": {
  "coin_api": {
    "command": "python",
    "args": ["-m", "coin_api_mcp"]
  },
  "env": {
        "COINMARKETCAP_API_KEY": "your_api_key_here"
  }
}

</details>

如果遇到任何问题，您可能需要使用您正在使用的 Python 解释器的完整路径。如果需要，您可以执行 which python 来查找确切的路径。

请记住设置 COINMARKETCAP_API_KEY 环境变量或通过 --api-key 参数提供它。

调试

您可以使用 MCP 检查器来调试服务器

贡献

我们鼓励您贡献力量，以帮助扩展和改进 Coin MCP 服务器。无论您是想添加新的搜索功能、增强现有功能还是改进文档，您的投入都很有价值。

有关其他 MCP 服务器和实现模式的示例，请参见： https://github.com/modelcontextprotocol/servers

欢迎提交 Pull Request！随时贡献新的想法、错误修复或增强功能，以使 Coin MCP 服务器更加强大和有用。

许可证

Coin MCP 服务器是在 MIT 许可证下获得许可的。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。有关更多详细信息，请参见项目存储库中的 LICENSE 文件。