Bitculator
Bitculator MCP 服务器

为你的 AI 助手提供实时加密数据

Bitculator MCP 服务器通过开放的 Model Context Protocol,将 Data API 以 19 个精心筛选的只读工具的形式开放。连接一次,你的助手就能用实时价格、历史数据、市场情绪与交易所情报作答。

端点
https://bitculator.com/mcp
传输方式
Streamable HTTP
身份验证
Bearer API 密钥
工具
19 个 · 只读

MCP(Model Context Protocol)是 AI 客户端用来访问外部工具的开放标准。任何支持通过 Streamable HTTP 连接远程服务器的客户端都能使用 Bitculator--下面的章节涵盖了常见的几种。所有价格、汇率、市值与供应量均以 decimal strings(十进制字符串)返回以保留精度,与 REST API 完全一致。

身份验证

服务器使用与 Data API 相同的密钥进行验证:在开发者控制台创建一个带 data-api 能力的密钥(免费套餐即可--无需绑卡),并在每个请求中作为 Bearer 请求头发送。嵌入密钥会被拒绝。

HTTP 请求头
Authorization: Bearer YOUR_API_KEY

没有有效密钥的请求会收到 401 unauthenticated。密钥属于机密--请在客户端设置或环境变量中配置,切勿写进会提交的共享文件。

Claude Code

一条命令即可为你的项目注册服务器(加上 --scope user 可在所有项目中使用)。当你询问市场行情时,Claude 会自动选择合适的工具。

terminal
claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

Cursor

将服务器添加到 ~/.cursor/mcp.json(全局)或项目内的 .cursor/mcp.json。保存文件后,工具会出现在 Cursor 的代理中。

~/.cursor/mcp.json
{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

将服务器添加到工作区的 .vscode/mcp.json。GitHub Copilot 的代理模式会自动列出 Bitculator 的工具。

.vscode/mcp.json
{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude API

正在 Anthropic API 上构建自己的应用?MCP 连接器可直接从 Messages API 调用访问服务器--将你的 Bitculator 密钥作为 authorization_token 传入即可。

POST /v1/messages
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

ChatGPT

ChatGPT 通过开发者模式连接远程 MCP 服务器:

  1. 在 ChatGPT 的设置中启用开发者模式(Apps & Connectors → Advanced)。
  2. 使用服务器 URL https://bitculator.com/mcp 添加一个连接器。
  3. ChatGPT 的连接器认证基于 OAuth--目前尚不支持 API 密钥请求头,因此基于密钥的访问请使用支持免认证的客户端或 Claude 系列产品。

OAuth 流程(以及随之而来的 ChatGPT + Claude 目录完整支持)已在路线图上。基于密钥的客户端--Claude Code、Cursor、VS Code、Claude API--今天即可使用。

配额与限制

MCP 是 Data API 的一个消费入口--没有单独的 MCP 账单或配额池。

  • 每次工具调用都按一次 Data API 请求计入你套餐的每月配额。
  • 套餐的每分钟突发限制按工具调用计(Free 30、Starter 60、Pro 120)。
  • 超出配额后,工具会返回 rate_limited 错误,告知助手配额池何时重置。受套餐限制的端点会返回 plan_required
  • 协议握手(initializetools/list)是免费的--只有工具调用才会消耗配额池。

智能体框架

正在构建自己的智能体?所有主流框架都内置了 MCP 客户端,可通过带 Bearer 标头的 Streamable HTTP 连接 -- 下面的代码片段会把全部 19 个工具作为原生函数加载。

OpenAI Agents SDK

pip install openai-agents
Python
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

Vercel AI SDK

npm i @ai-sdk/mcp
TypeScript
import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

LangChain

pip install langchain-mcp-adapters
Python
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

LlamaIndex

pip install llama-index-tools-mcp
Python
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

Mastra

npm i @mastra/mcp
TypeScript
import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

Semantic Kernel

pip install semantic-kernel[mcp]
Python
from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

工具参考

全部 19 个工具均为只读。参数与对应的 Data API 端点一致--相同的验证、相同的套餐门槛、相同的十进制字符串精度。

市场数据

工具

search_coins

按自由文本的名称或代码将币种或代币解析为其规范 slug,并为每个匹配项返回带排名的市场摘要。这是入口工具:其他所有币种工具都通过 slug 定位。

参数 类型 说明
query 必填 string 与币种名称和代码匹配的自由文本搜索。
type enum 限定匹配类型:coin 或 token。
limit integer 返回的最大匹配数(1-50,默认 10)。
工具

get_coin

单个币种的完整档案:供应量、排名与排名变动、历史最高/最低价及与其的差距、完全稀释估值、链接、合约与简介。

参数 类型 说明
slug 必填 string 规范币种 slug,例如 bitcoin。
工具

get_prices

一次调用获取最多 100 个币种的当前现货价格,可选择换算为某种法币。回答价格问题最省配额的方式--必须且只能提供一个选择器。

参数 类型 说明
slugs string 逗号分隔的币种 slug--首选的选择器。
symbols string 逗号分隔的代码符号;有歧义的符号会解析为排名最高的匹配项。
ids string 逗号分隔的 Bitculator 数字币种 id。
convert string 价格换算的目标法币符号,例如 EUR。默认为 USD。
工具

get_top_movers

按过去 24 小时或 7 天的百分比变化排出的最大涨幅或跌幅币种。

参数 类型 说明
direction 必填 enum gainers 或 losers。
interval enum 用于排名的变化窗口:24h 或 7d(默认 24h)。
limit integer 返回的最大币种数(1-50,默认 10)。

历史数据

工具

get_price_history

某币种在指定日期区间内的 OHLCV 蜡烛图。保留期:分钟级约 8 天,半小时级约 3 个月,小时级约 6 个月,日级 = 全部历史。返回窗口内最新的蜡烛,按从旧到新排序。

参数 类型 说明
slug 必填 string 规范币种 slug。
interval enum 蜡烛间隔:minutely、half-hourly、hourly 或 daily(默认 daily)。
start date 窗口起点,格式 YYYY-MM-DD;默认为与间隔匹配的近期窗口。
end date 窗口终点,格式 YYYY-MM-DD;默认为当前时间。
limit integer 返回的最大蜡烛数(1-500,默认 90)。
工具

get_historical_price

单个币种在某个特定历史日期的价格;当当天没有数据时,最多回退 3 天。

参数 类型 说明
slug 必填 string 规范币种 slug。
date 必填 date 日期,格式 YYYY-MM-DD(2009-01-01 或之后,不能是未来日期)。
工具

get_global_history

加密市场总市值或总成交量的时间序列。粒度随周期而定:24h 为半小时级,7d 为小时级,30d 与 all 为日级。

参数 类型 说明
metric 必填 enum 返回哪个序列:marketcap 或 volume。
period enum 窗口:24h、7d、30d 或 all(默认 24h)。

市场情绪与全局

工具

get_global_market

全市场快照:总市值、24 小时总成交量、BTC/ETH 市场份额,以及币种/代币/交易所/交易对数量。

此工具不需要任何参数。

工具

get_fear_greed

恐惧与贪婪情绪指数,覆盖全市场;传入 slug 时则针对单个币种,并包含 7d/30d 区间子分数。

参数 类型 说明
coin string 可选的币种 slug,用于获取单币种读数;省略则返回全市场指数。
工具

get_altseason_index

山寨季指数--山寨币是否正在跑赢比特币--可选附带每日历史数据。

参数 类型 说明
days integer 包含的每日历史天数(0-365;0 只返回当前读数)。
工具

get_liquidations_summary

今日期货清算总额,含多空拆分与占比。每日滚动结算刚过后数据可能为 null。

此工具不需要任何参数。

交易所

工具

list_exchanges

带 24 小时成交量、成交量份额及交易对/资产数量的交易所排名。也可将交易所名称解析为 slug。

参数 类型 说明
type enum 限定为中心化(cex)或去中心化(dex)交易所。
search string 与交易所名称匹配的自由文本搜索。
sort string 逗号分隔的排序字段,"-" 前缀表示降序:volume、rank、volume_dominance、change_24h、change_7d、pairs、assets。
limit integer 返回的最大交易所数(1-50,默认 10)。
工具

get_exchange

单个交易所的完整档案:排名、成交量及变化、市场份额、上架交易对与资产,以及链接。

参数 类型 说明
slug 必填 string 规范交易所 slug,例如 binance-exchange。
工具

get_exchange_trust_score

交易所的信任评分(0-10)及其完整的 13 项因子拆解。

参数 类型 说明
slug 必填 string 规范交易所 slug。
工具

get_coin_markets

币种的交易场所:其在各交易所的市场,含交易对、价格与 24 小时成交量,按成交量排序。

参数 类型 说明
slug 必填 string 规范币种 slug。
exchange string 可选的交易所 slug,用于将结果限定到一个交易场所。
instrument enum 限定为一种交易类型:spot、future、option、swap 或 margin。
limit integer 返回的最大市场数(1-50,默认 10)。

分析与实用工具

工具

get_coin_technicals

一次调用获取币种的多指标技术快照:RSI、MACD、SMA、ADX、MFI、CCI、OBV、VWAP、波动率等,每项都附最新状态与得分。

参数 类型 说明
slug 必填 string 规范币种 slug。
工具

convert_currency

使用实时汇率在任意加密货币和/或法币之间换算金额(每次调用最多 10 个目标),保留完整小数精度。

参数 类型 说明
from 必填 string 源货币 slug,例如 bitcoin 或 united-states-dollar。
to 必填 string 逗号分隔的目标货币 slug,最多 10 个。
amount number 要换算的源货币数量(默认 1)。
工具

calculate_dca

用真实价格历史回测定投(DCA)策略:总投入、累计币量、当前价值与盈亏。

参数 类型 说明
slug 必填 string 规范币种 slug。
amount 必填 number 每期买入的 USD 金额。
interval 必填 enum 买入频率:daily、weekly、monthly、quarterly 或 yearly。
start 必填 date 首次买入日期,格式 YYYY-MM-DD(须早于今天)。
end date 最后一次买入日期,格式 YYYY-MM-DD;默认为今天。
series boolean 是否包含逐笔买入序列(输出较大--除非被要求,否则保持 false)。