cryptoprice

Name: cryptoprice
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords金融数据02 周前更新

代码仓库

关于 cryptoprice

cryptoprice 是查询 CoinGecko 公开加密货币数据的命令行工具和 stdio MCP 服务，提供当前及历史行情、币种搜索、市场概况和热门数据，无需 API 密钥。

主要功能

01检查 CoinGecko API 状态
02获取当前价格和币种详情
03列出并搜索币种及交易所
04获取历史市场图表
05查看全球市场和热门数据

适用场景

01查询多个币种和货币的价格
02查找币种详情和交易所匹配项
03查看历史市场走势
04了解全球市场数据和热门资产

MCP 相关

它可作为 stdio MCP 服务运行，向 MCP 客户端提供 CoinGecko 状态、价格、币种数据、搜索、图表、全球数据及热门结果等工具。无需 API 密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-cryptoprice": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/cryptoprice"
      ]
    }
  }
}

启动命令npx -y @reneturcios/cryptoprice

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

安装包

npm@reneturcios/cryptoprice0.1.0stdio

ocighcr.io/cloudcorprecords/cryptoprice:0.1.0stdio

工具

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

此工具无需参数。

详细介绍

cryptoprice

cryptoprice 从 CoinGecko 读取公开的加密货币数据：API 是否正常运行、当前币价、单个币种的完整记录、完整币种列表、搜索币种和交易所、历史市场图表、全球市场概况以及热门趋势。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

无需 API 密钥。CoinGecko 的免费层无需密钥，因此无需任何配置即可使用 cryptoprice。如果你有演示密钥，可以设置 COINGECKO_API_KEY，该密钥会作为 x-cg-demo-api-key 标头发送；变量不存在或为空时，不会发送密钥标头，也不会因缺少密钥而失败。上游调用受免费层速率限制。

安装

npx @reneturcios/cryptoprice ping

或者运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/cryptoprice

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

cryptoprice ping
cryptoprice price bitcoin,ethereum usd,eur --change
cryptoprice coin bitcoin
cryptoprice coins --platform
cryptoprice search "wrapped bitcoin"
cryptoprice chart ethereum eur 30
cryptoprice global
cryptoprice trending

cryptoprice --version

每条命令都会输出上游 JSON 载荷。退出代码：成功时为 0，调用失败时为 1（包括速率限制等上游 API 错误），用法错误时为 2。

MCP 服务

一个二进制文件提供两种模式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/cryptoprice mcp

MCP 客户端配置：

{
  "mcpServers": {
    "cryptoprice": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cryptoprice", "mcp"]
    }
  }
}

工具

工具	输入	返回内容
`ping`	（无）	CoinGecko API 状态。
`get_price`	`ids`、`vs_currencies`（必需），`include_24hr_change`（可选）	当前价格，可选包含 24 小时涨跌幅。
`get_coin`	`id`（必需）	单个币种的完整数据：描述、链接和市场数据。
`list_coins`	`include_platform`（可选）	所有币种的 ID、符号和名称。
`search_coins`	`query`（必需）	与查询匹配的币种、交易所和类别。
`get_market_chart`	`id`、`vs_currency`、`days`（必需）	历史价格、市值和交易量。
`get_global_data`	（无）	总市值、交易量和市场占有率。
`get_trending`	（无）	热门币种、NFT 和类别。

所有调用都使用 https://api.coingecko.com/api/v3 下的 CoinGecko API。ids 和 id 等标识符是 CoinGecko ID（例如 bitcoin），而非符号。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx