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獲取詳細信息。