Cryptomcp

🚀 🪙 加密貨幣 MCP 服務器

一個使用 FastMCP 的服務器，可提供即時加密貨幣數據，數據源自 API 豬鼻 Crypto API。此服務器通過模型上下文協議（MCP）公開工具，讓兼容的客戶端（如Claude、Cursor等）能輕鬆查詢加密貨幣符號及其當前價格。

🚀 快速開始

按照以下步驟在本地設置並運行服務器。

先決條件

• Python 3.10 或更高版本
• git
• 虛擬環境工具（如 venv 或 uv）
• 來自 API 豬鼻 的 API 密鑰（具體針對 Crypto API）

安裝與設置

1. 克隆倉庫：

   git clone https://github.com/<your-username>/crypto-mcp-server.git # 替換為實際的倉庫 URL
   cd crypto-mcp-server
   

2. 創建並激活虛擬環境：
   • 使用 venv（標準庫）：

   python3 -m venv venv
   source venv/bin/activate # 在 Windows 上使用 `venv\Scripts\activate`
   

   • 使用 uv（如果已安裝）：

   uv venv venv
   source venv/bin/activate
   

3. 安裝依賴項：
   • 使用 pip（與 venv 一起使用）：

   pip install -e ".[dev]" # 安裝開發環境
   pip install -r requirements.txt # 安裝其他依賴項
   

   • 使用 uv：

   uv add crypto-mcp-server
   

4. 運行服務器：

   python -m fastmcp --config config.yaml
   

配置文件

創建一個配置文件 config.yaml，例如：

api_key: your_api_key_here

✨ 主要特性

• 列出符號：獲取所有可用加密貨幣符號的列表。
• 獲取價格：檢索特定符號的當前價格和時間戳。
• MCP 兼容性：使用 FastMCP 進行標準 MCP 通信。
• 異步 API 客戶端：使用 httpx 進行高效、非阻塞的 API 調用。
• 數據驗證：使用 pydantic 進行 robust 數據驗證。
• 經過測試：包括單元測試和集成測試（使用 pytest）。

📦 安裝指南

安裝開發環境

git clone https://github.com/your-username/crypto-mcp-server.git
cd crypto-mcp-server
pip install -e ".[dev]"

💻 使用示例

加密貨幣價格查詢

使用以下命令查詢加密貨幣的價格：

python -m fastmcp crypto_price --symbol BTC,ETH,XRP --interval 24H,7D

環境變量支持

您還可以通過環境變量配置 API 密鑰：

API_KEY=your_api_key_here python -m fastmcp crypto_price --symbol BTC,ETH,XRP

📚 詳細文檔

數據可視化

項目提供基本的數據可視化功能，幫助用戶更好地理解加密貨幣市場趨勢。

示例圖表

• 比特幣價格走勢圖：
• 以太坊價格對比圖：

數據源

該項目的數據來自 API 豬鼻 Crypto API，提供即時和歷史加密貨幣數據。

數據頻率

• 即時價格更新：每分鐘一次
• 歷史數據：按小時、天、周、月更新

開發與測試

運行測試

pytest tests/

🤝 貢獻指南

歡迎貢獻！請隨意打開問題或提交拉取請求。

📄 許可證

此項目在 MIT 許可證下，查看 LICENSE 文件以獲取詳細信息（假設 MIT，創建 LICENSE 文件）。