Coin Api MCP

🚀 Coin MCP 服务器

一个提供访问CoinMarketCap加密货币数据的模型上下文协议（Model Context Protocol）服务器。此服务器可助力AI驱动的应用程序检索加密货币列表、报价和各种代币的详细信息，为加密货币数据的获取提供了便捷途径。

🚀 快速开始

Coin MCP服务器允许AI应用程序访问CoinMarketCap的加密货币数据。下面将介绍可用工具、安装步骤、配置方法、调试方式、贡献指南和许可证信息。

✨ 主要特性

可用工具

• 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获取详细信息。