Coin MCP Server

这是一个提供访问CoinMarketCap加密货币数据的Model Context Protocol服务器。此服务器使AI驱动的应用程序能够检索加密货币列表、报价以及各种加密货币的详细信息。

可用工具

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

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

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

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

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

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

安装

通过Smithery安装

要通过Smithery自动安装Cryptocurrency Data for 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密钥。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 Server。无论您想添加新的搜索功能、增强现有功能还是改进文档，您的意见都是宝贵的。

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

欢迎提交拉取请求！请自由地贡献新想法、错误修复或改进，使Coin MCP Server更加强大和有用。

许可证

Coin MCP Server根据MIT许可证授权。这意味着您可以在遵守MIT许可证条款和条件的情况下自由使用、修改和分发软件。如需更多详情，请参阅项目存储库中的LICENSE文件。