这是一个基于Node.js和Express框架构建的MCP(Model Context Protocol)服务器,旨在通过标准的JSON-RPC协议,将CoinGecko的丰富加密货币市场数据提供给AI模型或兼容MCP的客户端(如Anthropic Claude桌面版)。服务器支持CoinGecko的免费和专业版API,并能自动切换。
主要功能点
- 加密货币数据访问: 提供获取加密货币价格、市场行情、交易量、交易对、历史数据等多种信息的能力。
- API灵活支持: 无缝集成CoinGecko免费API和专业版API,通过配置API Key自动选择。
- 标准MCP接口: 通过'/rpc'端点提供JSON-RPC 2.0接口,供AI客户端调用定义的工具。
- 能力声明: 在'/mcp/schema'端点提供标准的MCP Schema,允许AI客户端发现可用的数据访问工具及其参数。
安装步骤
该服务器需要 Node.js 和 npm 环境。
-
使用 npx (推荐): 这是最快的安装方式,会自动克隆仓库并引导配置。
npx coingecko-api-server按照提示选择安装目录并输入配置信息。
-
手动安装: 如果您想手动控制安装过程:
# 克隆仓库 git clone https://github.com/GaplyDev01/coingecko-api-server.git cd coingecko-api-server # 安装依赖 npm install # 运行配置脚本 (用于设置API Key和端口) npm run setup
服务器配置
服务器主要通过项目根目录下的 '.env' 文件进行配置。'npm run setup' 脚本会帮您创建或修改此文件。
- 'PORT': 服务器监听的端口号,默认为 '3000'。
- 'COINGECKO_API_KEY': 您的 CoinGecko 专业版 API Key。如果留空,服务器将使用免费API(有速率限制)。
基本使用方法
-
启动服务器: 在项目根目录下运行命令:
npm start服务器默认将在 'http://localhost:3000' 启动。
-
连接到MCP客户端: 服务器启动后,兼容MCP的AI客户端(例如Claude Desktop)可以通过提供服务器的URL地址(例如 'http://localhost:3000')来连接和集成此服务器。客户端会通过'/mcp/schema'端点获取服务器提供的工具定义,并通过'/rpc'端点调用这些工具来获取加密货币数据。
成功连接后,AI模型将能够利用此服务器提供的工具来回答关于加密货币的问题或执行相关任务。
信息
分类
网页与API