AI导哈

加密货币追踪服务

一个基于TypeScript和CoinGecko API的MCP服务器，提供实时加密货币数据、观察列表和金融分析提示。

  • by BugMentor
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 BugMentor/mcp-crypto

使用说明

加密跟踪器MCP服务器

一种模型上下文协议（MCP）服务器，提供实时加密货币数据、观察列表和财务分析提示。内置于 TypeScript 和那个 CoinGecko API.

🚀 功能此服务器实现以下MCP原语：

  • 工具:

  • get_crypto_price：获取加密货币的当前价格（支持BTC、ETH、SOL等Ticker）。

  • 资源:

  • crypto://watchlist：返回跟踪的加密货币的JSON列表。

  • 提示:

  • analyze_market：一个预先配置的提示，充当财务顾问来分析特定的硬币。

📋 先决条件

  • Node.js：版本18或更高版本。

  • npm：（包含在Node.js中）或 pnpm/yarn.

🛠️ 安装

  1. 克隆存储库：
git clone <your-repo-url>
cd crypto-tracker-server
  1. 安装依赖项：
npm install

🏃‍♂️ 如何运行（开发与调试）

该项目包括 MCP检查员，一个基于网络的工具，用于测试和调试您的工具和资源。

选项1：通用方法（推荐）

如果你添加了 start 脚本到您的 package.json:

npm start

选项2：特定于操作系统的脚本

如果您正在使用为此项目创建的手动脚本：

🪟 Windows（PowerShell）执行PowerShell脚本以启动检查器：

.\start.ps1

🍎 macOS/🐧 Linux（Bash）

首先，确保脚本可执行，然后运行它：

chmod +x start.sh
./start.sh

🔌 MCP客户端的配置

将此服务器与MCP客户端一起使用（如 Claude桌面应用程序)，您需要将其添加到配置文件中。

Claude桌面应用程序

  1. 打开配置文件：
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  1. 添加以下JSON配置：
{
  "mcpServers": {
    "crypto-tracker": {
      "command": "node",
      "args": ["--import", "tsx/esm", "/ABSOLUTE/PATH/TO/YOUR/PROJECT/src/index.ts"]
    }
  }
}

注： 替换 /ABSOLUTE/PATH/TO/YOUR/PROJECT/ 带有项目文件夹的实际完整路径。

📚 API 参考

工具

get_crypto_price：获取加密货币的当前美元价格。

  • 论据：
  • crypto_id （string，必填）：名称或股票代码（例如。， bitcoin, BTC, ethereum, SOL).

资源

crypto://watchlist：返回最喜欢的加密货币的静态列表。

  • MIME类型： application/json

提示

analyze_market：生成提示，让法学硕士担任财务顾问。

  • 论据：
  • coin （string）：要分析的硬币的名称。

🐛 故障排除

错误： MCP error -32603: Cannot read properties of undefined (reading 'list')

  • 如果 capabilities 初始化过程中缺少对象。
  • 修复： 确保您的 new McpServer() 构造函数包括显式 capabilities 对象（这在提供的 index.ts).

CoinGecko API错误

  • 此服务器使用免费的公共CoinGecko API。它有速率限制（约10-30个呼叫/分钟）。如果您看到连接错误，请稍候，然后重试。

📄 许可证MIT许可证

版权所有（c）2025

特此免费授予任何获得本软件和相关文档文件（“软件”）副本的人在不受限制的情况下处理软件的权限，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，以及允许获得软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或实质部分中。

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。

相关 MCP