mcpField
C
CoinGecko MCP

CoinGecko MCP

本地服务
github.com/coingecko金融数据592 天前更新

关于 CoinGecko MCP

CoinGecko MCP 是 CoinGecko 官方提供的 MCP 服务,用于获取加密货币价格和市场数据。它以 Code Mode 方式运行,由 Agent 编写 TypeScript 代码调用 SDK,并支持本地与远程两种运行方式。

主要功能

  1. 01通过 Code Mode 调用 TypeScript SDK
  2. 02提供文档搜索工具
  3. 03代码在 Deno 沙箱中执行
  4. 04支持 Streamable HTTP 远程运行
  5. 05通过 API Key 请求头完成鉴权

适用场景

  1. 01查询加密货币价格与市场数据
  2. 02让 Agent 编写代码完成多步数据分析
  3. 03将 MCP 服务部署为远程服务供团队使用

MCP 相关

该项目是 MCP 服务,向 MCP 客户端暴露两个工具:文档搜索工具和代码执行工具,后者用于调用 CoinGecko SDK。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"coingecko-2": {
"command": "npx",
"args": [
"-y",
"@coingecko/coingecko-mcp"
],
"env": {
"COINGECKO_PRO_API_KEY": "<COINGECKO_PRO_API_KEY>",
"COINGECKO_DEMO_API_KEY": "<COINGECKO_DEMO_API_KEY>",
"COINGECKO_ENVIRONMENT": "<COINGECKO_ENVIRONMENT>"
}
}
}
}
启动命令npx -y @coingecko/coingecko-mcp
需要配置的环境变量
COINGECKO_PRO_API_KEY密钥
COINGECKO_DEMO_API_KEY密钥
COINGECKO_ENVIRONMENT

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@coingecko/coingecko-mcp

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
endpointstring是要获取其架构的端点名称。

详细介绍

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 中找到。

添加到 Cursor

VS Code

如果你使用 MCP,可以点击下方链接安装 MCP 服务。你需要在 VS Code 的 mcp.json 中设置环境变量, 该文件可通过命令面板 > MCP: Open User Configuration 找到。

打开 VS Code

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-keyproAPIKeyproKeyAuth
x-cg-demo-api-keydemoAPIKeydemoKeyAuth

假设服务托管在 http://localhost:3000,其配置 JSON 可能如下所示:

{
  "mcpServers": {
    "coingecko_coingecko_typescript_api": {
      "url": "http://localhost:3000",
      "headers": {
        "x-cg-pro-api-key": "My Pro API Key"
      }
    }
  }
}

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。