关于 CoinGecko MCP
CoinGecko MCP 是 CoinGecko 官方提供的 MCP 服务,用于获取加密货币价格和市场数据。它以 Code Mode 方式运行,由 Agent 编写 TypeScript 代码调用 SDK,并支持本地与远程两种运行方式。
主要功能
- 01通过 Code Mode 调用 TypeScript SDK
- 02提供文档搜索工具
- 03代码在 Deno 沙箱中执行
- 04支持 Streamable HTTP 远程运行
- 05通过 API Key 请求头完成鉴权
适用场景
- 01查询加密货币价格与市场数据
- 02让 Agent 编写代码完成多步数据分析
- 03将 MCP 服务部署为远程服务供团队使用
MCP 相关
该项目是 MCP 服务,向 MCP 客户端暴露两个工具:文档搜索工具和代码执行工具,后者用于调用 CoinGecko SDK。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| endpoint | string | 是 | 要获取其架构的端点名称。 |
详细介绍
Coingecko TypeScript MCP 服务
此项目由 Stainless 生成。
安装
直接调用
你可以通过 npx 直接运行 MCP 服务:
export COINGECKO_PRO_API_KEY="My Pro API Key"
export COINGECKO_DEMO_API_KEY="My Demo API Key"
export COINGECKO_ENVIRONMENT="pro"
npx -y @coingecko/coingecko-mcp@latest
通过 MCP 客户端
modelcontextprotocol.io 上列出了一部分现有客户端。如果你已经 有客户端,请查阅其文档以安装 MCP 服务。
对于支持配置 JSON 的客户端,配置可能如下所示:
{
"mcpServers": {
"coingecko_api": {
"command": "npx",
"args": ["-y", "@coingecko/coingecko-mcp"],
"env": {
"COINGECKO_PRO_API_KEY": "My Pro API Key",
"COINGECKO_DEMO_API_KEY": "My Demo API Key",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
Cursor
如果你使用 Cursor,可以使用下方的按钮安装 MCP 服务。你需要在 Cursor 的 mcp.json 中设置环境变量,
该文件可在 Cursor 设置 > Tools & MCP > New MCP Server 中找到。
VS Code
如果你使用 MCP,可以点击下方链接安装 MCP 服务。你需要在 VS Code 的 mcp.json 中设置环境变量,
该文件可通过命令面板 > MCP: Open User Configuration 找到。
Claude Code
如果你使用 Claude Code,可以在终端中运行下方命令来安装 MCP 服务。你需要在 Claude Code 的 .claude.json 中设置环境变量,
该文件位于你的主目录中。
claude mcp add coingecko_coingecko_mcp_api --env COINGECKO_PRO_API_KEY="My Pro API Key" COINGECKO_DEMO_API_KEY="My Demo API Key" -- npx -y @coingecko/coingecko-mcp
代码模式
此 MCP 服务基于“代码模式”工具方案构建。在此 MCP 服务中, 你的 Agent 将针对 TypeScript SDK 编写代码,然后在沙盒中执行。为此,服务将向你的 Agent 提供两个工具:
-
第一个工具是文档搜索工具,可用于通用查询有关 API/SDK 的文档。
-
第二个工具是代码工具,Agent 可通过它针对 TypeScript SDK 编写代码。 代码会在沙盒中执行,其文件系统和网络访问权限仅限于 SDK 所需范围——请参阅下文的“代码运行位置”。之后,代码返回或 打印的任何内容都会作为工具调用结果返回给 Agent。
使用此方案,Agent 能够以确定且可重复的方式执行非常复杂的任务。
代码运行位置
此服务在本地运行代码。每次代码工具调用都会在 MCP 服务所在的同一台机器上的 Deno 子进程中执行,仅允许读取服务自身的文件,以及向你的 API 主机发起网络请求。
代码工具需要安装 Deno 才能运行。请从 https://deno.land 安装,或使用 npm install deno 将其添加到 MCP 服务的依赖项中。
远程运行
使用 --transport=http 启动客户端会以远程服务的形式启动服务,并使用 Streamable HTTP 传输。--port 设置可选择服务运行的端口,--socket 设置则允许服务通过 Unix 套接字运行。
可以通过以下请求头提供授权:
| 请求头 | 等效客户端选项 | 安全方案 |
|---|---|---|
x-cg-pro-api-key | proAPIKey | proKeyAuth |
x-cg-demo-api-key | demoAPIKey | demoKeyAuth |
假设服务托管在 http://localhost:3000,其配置 JSON 可能如下所示:
{
"mcpServers": {
"coingecko_coingecko_typescript_api": {
"url": "http://localhost:3000",
"headers": {
"x-cg-pro-api-key": "My Pro API Key"
}
}
}
}
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。