MCP Server Coingecko

🚀 加密货币市场 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