coincap-mcp

你是否曾经想知道比特币现在的价格，或者以太坊的市值是多少？你又是否希望 AI 助手能够实时回答这些问题，而不是给出一个可能过时的训练数据中的数字？加密货币市场瞬息万变，价格每秒都在波动，传统的语言模型无法感知这些实时变化。

这就是 coincap-mcp 要解决的问题。它是一个基于模型上下文协议的服务器，通过 CoinCap 的公开 API，让 AI 模型能够实时访问加密货币的价格、市值、供应量等数据。最棒的是，这个 API 完全免费，不需要注册，也不需要 API 密钥。

项目基本信息

一、项目介绍

coincap-mcp 是一个轻量级的 MCP 服务器，它封装了 CoinCap 的公开 API。CoinCap 是一个提供实时加密货币数据的平台，覆盖了数千种资产的价格、市值、交易量和供应量信息。

该服务器提供了三个核心工具：

• 比特币价格工具：专门获取比特币的当前价格。
• 通用加密货币价格工具：获取任意支持币种的实时价格。
• 列出所有资产工具：获取 CoinCap 支持的所有加密货币资产列表，包括名称、符号、价格、市值等。

这个项目的特别之处在于，它不需要任何注册或 API 密钥。你只需安装并配置，就可以让 AI 助手立即获得查询实时加密市场数据的能力。

二、核心优势

无需 API 密钥，开箱即用
与其他需要注册、申请密钥的服务不同，CoinCap 的公共 API 完全免费且无认证要求。这意味着你可以在几分钟内完成配置，没有任何障碍。

简单直接的三个工具
服务器只提供了三个工具，职责清晰：一个专门查比特币，一个查任意币种，一个列出所有资产。这种设计让 AI 非常容易理解和调用。

实时数据
通过 API 获取的数据是实时的（通常延迟在几秒内）。你可以让 AI 回答“比特币现在多少钱？”这样的问题，得到的是当前价格，而不是几个月前的训练数据。

通过 Smithery 一键安装
项目支持通过 Smithery 安装到 Claude Desktop，无需手动克隆或构建。这进一步降低了使用门槛。

开源且易扩展
项目采用 MIT 许可证，代码量不大，结构清晰。如果你需要更多的指标（如交易量、价格变化百分比），可以轻松修改源码来扩展。

三、适用场景

个人投资助手
你可以问：“比特币今天的价格和一周前相比，涨了还是跌了？” AI 可以获取当前价格，并调用历史数据 API（如果服务器扩展了该功能）来计算变化。

市场监控
让 AI 定期（通过你的手动查询）检查你关注的几个币种的价格：“检查一下以太坊、Solana 和 Cardano 的当前价格。”

学习和教育
向学生演示 MCP 如何让 AI 访问实时数据。这是一个非常生动的例子，因为结果直观且有实时性。

组合分析
你可以列出市值前 10 的加密货币，然后让 AI 根据价格和市值计算它们各自的市占率。

聊天机器人插件
为你的 Telegram 或 Discord 机器人增加一个命令“/crypto BTC”，通过 MCP 查询价格并回复。

四、安装教程

安装 coincap-mcp 非常简单，推荐使用 Smithery 一键安装。

准备工作

确保你已经安装了 Node.js 18 或更高版本。可以通过 node -v 命令检查。

方法一：通过 Smithery 安装（推荐）

关闭 Claude Desktop，在终端中运行：

npx -y @smithery/cli install coincap-mcp --client claude

等待命令执行完成，然后重新启动 Claude Desktop。右侧应能看到工具图标。

方法二：手动配置

如果你希望手动配置，或将服务器用于其他客户端，请按以下步骤操作。

1. 全局安装 npm 包：

npm install -g coincap-mcp

2. 配置 Claude Desktop：编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %AppData%\Claude\claude_desktop_config.json），添加以下内容：

{
  "mcpServers": {
    "coincap": {
      "command": "npx",
      "args": ["coincap-mcp"]
    }
  }
}

3. 保存文件，完全重启 Claude Desktop。

验证安装

重启后，你可以问 Claude：“比特币现在的价格是多少？” 如果它能够给出一个接近实时价格的数字，说明安装成功。

五、使用示例

以下是在配置好服务器后，与 Claude 的自然语言对话示例。

示例1：查询比特币价格

用户输入：比特币现在多少钱？

Claude 会调用 bitcoin_price 工具（或 get_crypto_price 工具，参数为 "bitcoin"），然后回答：“根据实时数据，比特币当前价格为 63,245 美元。”

示例2：查询任意币种价格

用户输入：查一下 Solana 的当前价格。

Claude 会调用 get_crypto_price 工具，参数为 "solana"，返回类似“Solana 现在的价格是 156.32 美元”的结果。

示例3：列出所有资产

用户输入：帮我列出 CoinCap 上市值前五的加密货币。

Claude 会调用 list_assets 工具，然后从返回的数据中按市值排序，找出前五名（通常是 Bitcoin、Ethereum、Tether、BNB、Solana）。

示例4：组合查询

用户输入：比较一下以太坊和莱特币的当前价格和市值。

Claude 会两次调用 get_crypto_price（或一次 list_assets 然后提取），然后为你生成对比表格或文本描述。

六、常见问题

问题1：查询价格时返回“找不到该资产”的错误。

解决方案：请确保你使用的币种名称是 CoinCap API 识别的。通常使用小写名称，如 "bitcoin"、"ethereum"。可以先用 list_assets 工具查看所有支持的资产及其 ID。

问题2：价格数据有多及时？

解决方案：CoinCap 公开 API 的更新频率通常是几秒钟一次。对于大多数个人用途，这已经足够实用了。但如果你需要毫秒级的交易数据，则不适合。

问题3：这个服务器能获取历史价格吗？

解决方案：目前版本的工具不直接支持历史价格。但是，CoinCap API 本身支持查询历史数据。你可以扩展服务器，增加一个 get_historical_price 工具，传入日期参数。

问题4：使用 Smithery 安装后，Claude 中没有出现工具。

解决方案：请确保在运行安装命令前完全退出了 Claude Desktop。安装完成后，手动重启 Claude。有时需要等待几秒钟让工具加载。如果问题依旧，可以尝试手动配置方法。

问题5：我可以同时用它查询多个币种的价格吗？

解决方案：Claude 可以通过一次对话多次调用工具。例如，你问“BTC、ETH、SOL 的价格分别是多少？”，Claude 可能会依次调用三次 get_crypto_price，然后汇总结果。要做到一次 API 请求获取多个币种，可以扩展 list_assets 工具，允许传入一个 ID 列表。

七、总结

coincap-mcp 是一个简洁、实用且完全免费的 MCP 服务器。它完美地体现了 MCP 协议的一个核心价值：让 AI 突破训练数据的限制，获得实时、动态的外部信息。

这个项目的最大亮点是 零门槛：无需注册、无需 API 密钥，通过 Smithery 一键安装即可使用。3 个核心工具覆盖了最常用的加密数据查询场景。

对于加密货币爱好者、投资者，或者只是想学习 MCP 的开发者来说，coincap-mcp 是一个非常棒的起点。92 颗星或许不高，但它的实用性和简洁性值得更多关注。