🚀 我的加密货币 MCP

本项目的模型上下文协议（MCP）服务器借助Claude Desktop，为用户提供加密货币信息。它通过连接CoinMarketCap API，获取实时的加密货币数据，为用户的投资决策提供有力支持。

✨ 主要特性

• 通过符号获取当前加密货币信息，让您随时掌握市场动态。
• 查看示例加密货币投资组合，为您的投资提供参考。

📦 安装指南

先决条件

• Claude Desktop
• Node.js（v16或更高版本）
• CoinMarketCap API密钥（可在coinmarketcap.com/api获取）

安装步骤

1. 安装依赖项

npm install

2. 构建项目

npm run build

3. 配置Claude Desktop

将MCP服务器添加到Claude Desktop，需编辑Claude配置文件，具体步骤如下：

1. 打开Claude Desktop设置。
2. 添加以下配置：

{
  "mcpServers": {
    "crypto": {
      "command": "node",
      "args": ["/绝对路径/你的项目/build/index.js"],
      "env": {
        "CMC_API_KEY": "你的CoinMarketCap API密钥"
      }
    }
  }
}

⚠️ 重要提示

请将 /绝对路径/你的项目 替换为实际的项目目录路径，将 你的CoinMarketCap API密钥 替换为您的实际CoinMarketCap API密钥。

4. 重启Claude Desktop

添加配置后，重启Claude Desktop以加载MCP服务器。

💻 使用示例

基础用法

一旦完成配置，您就可以在与Claude的聊天中使用以下命令获取投资组合信息：

1. 添加投资组合资源

通过附件按钮在Claude Desktop中附加portfolio资源。

2. 提问

您可以提出类似如下的问题：

我的投资组合当前价值是多少？

Claude将从CoinMarketCap API获取最新信息，并提供有关您投资组合的详细信息。

示例响应

以下是Claude可能返回的内容示例：

根据您的投资组合和当前市场价格，截至2025年4月27日，您的加密货币持有量的价值如下：

ZK（ZKsync）：69,696 ZK × $0.06051 = $4,217.48
比特币（BTC）：9,696 BTC × $94,361.18 = $914,904,201.28
以太坊（ETH）：23,456 ETH × $1,803.33 = $42,288,825.48

总投资组合价值：$957,197,244.24
您的投资组合主要由比特币 holdings 组成，其代表了您总投资组合价值的超过95%。您需要有关市场趋势或投资组合建议的任何其他信息吗？

🔧 技术细节

• 源代码位于src目录中。
• 主MCP服务器在index.ts中定义。
• API交互处理在helper.ts中进行。

📚 详细文档

故障排除

如果遇到问题，可按以下步骤排查：

1. 检查您的CoinMarketCap API密钥是否有效。
2. 验证Claude Desktop配置中的构建文件路径。
3. 检查控制台输出中的任何错误消息。