内容
# CryptoDataAPI MCP 服务器
一个 [MCP（模型上下文协议）](https://modelcontextprotocol.io) 服务器，通过 [CryptoDataAPI](https://cryptodataapi.com) 为 AI 代理提供实时的加密货币市场数据。
## 您将获得
**13 个工具**，涵盖整个加密货币市场：
| 工具 | 描述 |
|------|-------------|
| `get_daily_snapshot` | 单次调用获取完整的市场概览 — 健康评分、衍生品、情绪、宏观、ETF 资金流、周期指标 |
| `get_market_health` | 双评分市场健康系统（0-100），具有状态分类 |
| `get_fear_greed` | 恐惧与贪婪指数（多源平均，0-100） |
| `get_funding_rates` | 跨交易所永续合约资金利率 |
| `get_liquidations` | 跨交易所爆仓量（多头 + 空头） |
| `get_open_interest` | 跨交易所未平仓合约量，附 24 小时变化 |
| `get_btc_cycle` | 8 个 BTC 周期指标（MVRV、NUPL、Puell、Pi Cycle 等） |
| `get_coin_profile` | 详细的币种数据 — 价格、市值、变化、历史高低点 |
| `search_coins` | 按名称或符号搜索币种 |
| `get_macro` | 宏观指标 — EUR/USD、黄金、国债收益率 |
| `get_stablecoin_flows` | 稳定币市值和资金流 |
| `get_etf_flows` | BTC/ETH/SOL/XRP 现货 ETF 每日资金流 |
| `get_options` | BTC 期权数据 — 未平仓合约量、交易量、买入/卖出比率、最大痛点 |
**1 个提示**，用于结构化分析：
| 提示 | 描述 |
|--------|-------------|
| `crypto_market_briefing` | 生成结构化的市场报告，包括状态、衍生品、情绪、宏观和总结 |
## 设置
### 1. 获取 API 密钥
在 [cryptodataapi.com](https://cryptodataapi.com) 注册并创建 API 密钥。
### 2. 配置您的 AI 客户端
#### Claude 桌面版
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`：
```json
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": {
"CRYPTODATA_API_KEY": "cdk_live_your_key_here"
}
}
}
}
```
#### Claude 代码
```bash
claude mcp add cryptodataapi -- npx -y cryptodataapi-mcp
```
然后在您的 shell 配置文件中设置环境变量：
```bash
export CRYPTODATA_API_KEY="cdk_live_your_key_here"
```
#### Cursor
添加到项目中的 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"cryptodataapi": {
"command": "npx",
"args": ["-y", "cryptodataapi-mcp"],
"env": {
"CRYPTODATA_API_KEY": "cdk_live_your_key_here"
}
}
}
}
```
## 示例用法
配置完成后，您可以询问您的 AI：
- "给我一份加密货币市场简报"
- "当前的恐惧与贪婪指数是多少？"
- "显示我各交易所的 BTC 永续合约资金利率"
- "我们目前处于 BTC 周期的哪个阶段？"
- "比特币的 ETF 资金流情况如何？"
- "查找 Solana 币种资料"
## 环境变量
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `CRYPTODATA_API_KEY` | 是 | 您的 CryptoDataAPI 密钥（以 `cdk_live_` 开头） |
| `CRYPTODATA_API_URL` | 否 | 基础 URL 重定向（默认为 `https://cryptodataapi.com`） |
## 开发
```bash
npm install
npm run build
npm start
```
使用 MCP 检测器进行测试：
```bash
CRYPTODATA_API_KEY=cdk_live_xxx npx @modelcontextprotocol/inspector node dist/index.js
```
## 许可证
MIT
