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 文件）。