加密货币市场 MCP 服务器

一个实现 Model Context Protocol（MCP）协议的服务器，提供通过 CoinGecko 访问加密货币市场数据的工具。

安装依赖

运行以下命令安装所需的依赖项：

npm install

创建 .env 文件

在项目根目录中创建一个 .env 文件，并添加你的 CoinGecko API 密钥：

# API Keys
COINGECKO_API_KEY=your_coingecko_api_key_here

构建项目

运行以下命令构建项目：

npm run build

启动服务器

运行以下命令启动服务器：

npm start

已提供的工具

获取加密货币市场图表数据

此工具用于获取特定加密货币的历史市场图表数据，包括价格、市值和成交量。

参数（均使用 Zod 进行验证）：

• coinId（可选）：要获取数据的加密货币 ID（例如，'bitcoin'，'ethereum'）。默认为 'bitcoin'。
• vsCurrency（可选）：显示价格的货币单位（例如，'usd'，'eur'，'jpy'）。默认为 'usd'。
• days（可选）：要获取的数据天数（例如，'1'，'14'，'30'，'90'，'max'）。默认为 '30'。
• interval（可选）：数据的时间间隔。留空则根据时间范围自动选择。

示例用法：

{
  "coinId": "ethereum",
  "vsCurrency": "usd",
  "days": "7"
}

CoinGecko API 文档

有关 CoinGecko API 的更多信息，请参阅官方文档：

• CoinGecko API 文档
• 按 ID 获取加密货币历史价格图表数据

开发

使用以下命令进行开发并自动重新编译：

npm run dev

功能

• 实现 Model Context Protocol（MCP）
• 使用 TypeScript 编写
• 使用标准输入输出（stdio）进行通信
• 提供加密货币市场数据，通过 CoinGecko API
• 使用 Zod 进行参数验证

实现细节

此服务器使用 @modelcontextprotocol/sdk 创建一个 MCP 服务器，实现以下功能：

1. 通过 stdio 进行通信
2. 提供历史市场图表数据
3. 遵循 ES 模块模式
4. 使用 Zod 方案验证输入参数

扩展服务器

要扩展此服务器：

1. 使用 server.tool() 方法添加更多工具
2. 实现其他 CoinGecko API 端点
3. 尝试其他传输方法，例如 HTTP 或 WebSocket