# @coingecko/coingecko-mcp 中文文档

规范地址：https://npmcn.com/package/%40coingecko/coingecko-mcp/

版本：9\.0\.0
npm 元数据更新时间：2026-11-04T08:59:37.781Z
中文译文更新时间：2026-11-10T10:59:07.525Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40coingecko/coingecko-mcp
原文对照：https://npmcn.com/package/%40coingecko/coingecko-mcp/?lang=original
项目主页：https://github.com/coingecko/coingecko-typescript/tree/main/packages/mcp-server#readme
源码仓库：https://github.com/coingecko/coingecko-typescript

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2 MB，162 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：22 个
- 首次发布：2025-06-05T10:51:41.372Z
- 最新版本发布：2026-11-04T08:59:37.382Z
- 近 30 天下载量：3160（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：50（近 12 个月 20 个）

## 中文简介

Coingecko API的官方MCP服务器

## 安装

```sh
npm install @coingecko/coingecko-mcp
```

也可以使用：`pnpm add @coingecko/coingecko-mcp`、`yarn add @coingecko/coingecko-mcp`、`bun add @coingecko/coingecko-mcp`

## README

# Coingecko 类型脚本 MCP 服务器

它的产生与 [无污](https://www.stainless.com/)。 。 。 .

## 安装

### 直接援引

您可以直接通过 MCP 服务器运行 `npx`数字 :

```sh
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 客户端

现有客户清单 [模型文本protocol.io](https://modelcontextprotocol.io/clients)。如果已经 拥有客户端,请查看他们的文档以安装MCP服务器.

对于JSON配置的客户来说,它可能看起来是这样的:

```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,可以通过使用下面的按钮来安装MCP服务器. 您需要设置环境变量 在光标中 `mcp.json`,可以在光标设置中找到 > 工具 & MCP > 新建 MCP 服务器.

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=%40coingecko%2Fcoingecko-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjb2luZ2Vja28vY29pbmdlY2tvLW1jcCJdLCJlbnYiOnsiQ09JTkdFQ0tPX1BST19BUElfS0VZIjoiTXkgUHJvIEFQSSBLZXkiLCJDT0lOR0VDS09fREVNT19BUElfS0VZIjoiTXkgRGVtbyBBUEkgS2V5In19)

### VS 代码

如果您使用MCP,可以通过点击下面的链接来安装MCP服务器. 您需要设置环境变量 vS 代码 `mcp.json`,可以通过Command Palette > MCP:开放用户配置找到.

[打开 VS 代码](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22%40coingecko%2Fcoingecko-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40coingecko%2Fcoingecko-mcp%22%5D%2C%22env%22%3A%7B%22COINGECKO_PRO_API_KEY%22%3A%22My%20Pro%20API%20Key%22%2C%22COINGECKO_DEMO_API_KEY%22%3A%22My%20Demo%20API%20Key%22%7D%7D)

### 克劳德代码

如果您使用克洛德代码,可以通过在您的终端运行下面的命令来安装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服务器中, 您的代理将针对 TypeScript SDK 写入代码, 然后在 沙盒 沙盒 沙盒 沙盒 沙盒 为了完成这个任务,服务器将向您的代理商披露两个工具:

-   第一个工具是Docs搜索工具,可用于通用查询 有关您的 API/ SDK 的文档.
    
-   第二个工具是一个代码工具,代理可以针对TypeScript SDK写入代码. 代码在一个沙盒中执行,其文件系统和网络访问被限制在 sDK需要的东西——见下面"代码运行的地方". 然后,任何代码返回或 由于工具调用的结果,指纹将返回代理.
    

利用这个办法,代理人能够执行非常复杂的任务 和重复的.

### 代码运行的地方

此服务器在本地运行代码 。 每个代码工具调用在 和MCP服务器相同的机器,仅限于读取服务器自己的文件和制作 网络请求您的 API 主机 .

代码工具必须安装Deno才能工作. 安装它从 [https://deno.land (英语)](https://deno.land/),或添加该词 到 MCP 服务器的依赖性 `npm install deno`。 。 。 .

## 远程运行

启动客户端 `--transport=http` 使用可流式HTTP传输将服务器作为远程服务器发射. 这个 `--port` 设置可以选择它运行的端口,以及 `--socket` 设置允许它在 Unix 套接字上运行.

可通过下列标题提供授权:

| 页眉 | 等同客户端选项 | 保安计划 |
| --- | --- | --- |
| `x-cg-pro-api-key` | `proAPIKey` | proKeyAuth 证书 |
| `x-cg-demo-api-key` | `demoAPIKey` | 演示密钥认证 |

假设服务器位于 `http://localhost:3000`数字 :

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

## 常见问题

### @coingecko/coingecko-mcp 是什么？

Coingecko API的官方MCP服务器

### 如何安装 @coingecko/coingecko-mcp？

在项目目录运行 npm install @coingecko/coingecko-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server，可以用 npx mcp-server 直接运行。

### @coingecko/coingecko-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @coingecko/coingecko-mcp 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @coingecko/coingecko-mcp 可以商用吗？

@coingecko/coingecko-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @coingecko/coingecko-mcp 的下载量有多少？

根据 npm 官方下载统计，@coingecko/coingecko-mcp 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,160 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @coingecko/coingecko-mcp 还在维护吗？

最新版本 9\.0\.0 发布于 2026/11/04（6 天前）；至今共发布 50 个版本，其中过去 12 个月发布了 20 个；首次发布于 2025/06/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。