blockchainacademics

@blockchainacademics/mcp

面向 AI Agent 的权威加密货币 MCP 服务。105 个工具，涵盖 3,501+ 篇编辑文章、200+ 个实体档案、43 节学院课程、聚合市场与链上数据、专有指标，以及由 Agent 异步生成的内容——所有内容均可作为 MCP 工具供你的 AI Agent 原生调用。

工具类别（v0.4.0）

类别	数量	示例
内容与语料库	7	search_news、get_article、get_entity、get_explainer、list_entity_mentions、get_as_of_snapshot
市场数据	4	get_price、get_ohlc、get_market_overview、get_pair_data
链上数据	4	get_wallet_profile、get_tx、get_token_holders、get_defi_protocol
情绪	3	get_sentiment、get_social_pulse、get_fear_greed
专有指标	6	get_coverage_index、get_narrative_strength、get_sentiment_velocity、get_editorial_premium、get_kol_influence、get_risk_score
Agent 支持（异步，Pro+）	6	generate_due_diligence、generate_tokenomics_model、summarize_whitepaper、translate_contract、monitor_keyword、get_agent_job
目录	13	list_stablecoins、list_yields、list_aggregators、list_mcps、list_vcs、list_jobs、build_custom_indicator、…
基本面	6	get_tokenomics、get_audit_reports、get_team_info、compare_protocols、check_rugpull_risk
特定链	4	get_solana_ecosystem、get_l2_comparison、get_bitcoin_l2_status、get_ton_ecosystem
市场微观结构	5	get_funding_rates、get_options_flow、get_liquidation_heatmap、get_exchange_flows、predict_listing
叙事／元数据	5	track_narrative、get_ai_agent_tokens、get_depin_projects、get_rwa_tokens、get_prediction_markets
监管	4	get_regulatory_status、track_sec_filings、get_mica_status、get_tax_rules
安全	4	check_exploit_history、check_phishing_domain、get_bug_bounty_programs、scan_contract
Meme／Degen	4	track_pumpfun、track_bonkfun、check_memecoin_risk、get_degen_leaderboard
服务（收入）	3	book_kol_campaign、request_custom_research、submit_listing
历史时间序列	4	get_history_prices、get_history_sentiment、get_history_correlation、get_history_coverage
计算／AI 加密货币	2	get_compute_pricing、get_ai_crypto_metrics
语料库元数据	7	list_entities、get_topic、search_academy、get_trending、get_unified_feed、list_sources、get_recent_stories
备忘录、论点与社交	6	list_memos、get_memo、list_theses、get_thesis、get_social_signals、get_social_signals_detail
货币	2	list_currencies、get_currency_feed

每个工具响应都包含 cite_url（带有 UTM 来源归因）、as_of（时光回溯快照）和 source_hash（内容完整性校验）。

对于尚未发布的集成（Twitter 社交脉动、DEXTools、bonk.fun、Bittensor），工具会返回 {status: "integration_pending", reason, eta}，而不是报错。MCP 服务目前已可完整使用。

为什么

大模型会对加密货币产生幻觉。BCA 提供有完整归因的真实编辑内容。将此 MCP 服务接入 Claude Desktop、LangChain、Eliza 或任何兼容 MCP 的 Agent，你的模型就能像调用其他工具一样查询 BCA 语料库——每个响应都附带引用、时间戳和来源哈希。

安装

Claude Desktop（零配置演示）

此软件包内置了一个公开演示密钥。无需注册即可试用。将以下内容添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

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

重启 Claude Desktop。演示模式可使用 10 个主要工具（get_price、get_trending、get_fear_greed、get_market_overview、search_news、get_sentiment、get_entity、get_explainer、get_recent_stories、get_topic），提供真实数据和真实引用。共享速率上限：全局每天 100 次调用，每个 IP 每天 20 次。

Claude Desktop（完整的 105 个工具）

在 brain.blockchainacademics.com/signup 获取免费密钥（每位用户每月 2,000 次调用），并添加环境变量块：

{
  "mcpServers": {
    "blockchainacademics": {
      "command": "npx",
      "args": ["-y", "@blockchainacademics/mcp"],
      "env": { "BCA_API_KEY": "bca_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

重启 Claude Desktop。所有 105 个工具都会出现在工具选择器中。

程序化使用（LangChain、Eliza、自定义 Agent）

npm install @blockchainacademics/mcp

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "@blockchainacademics/mcp"],
  env: { BCA_API_KEY: process.env.BCA_API_KEY! },
});
const client = new Client({ name: "my-agent", version: "0.0.1" }, { capabilities: {} });
await client.connect(transport);

const res = await client.callTool({
  name: "search_news",
  arguments: { query: "stablecoin regulation", limit: 5 },
});
console.log(res.content);

完整的工具链调用循环示例，请参见 examples/research-agent.ts。

工具

search_news

在 3,501 篇以上的加密货币编辑文章中进行全文搜索。

参数	类型	必填	描述
query	string (1-512)	是	搜索查询
entity	string	否	实体 slug 筛选条件（例如 ethereum）
since	ISO 8601	否	最早发布日期
topic	string	否	主题筛选条件（例如 regulation）
limit	number (1-50)	否	默认值为 10

示例：{ "query": "circle IPO", "since": "2026-01-01T00:00:00Z", "limit": 5 }

get_entity

获取规范实体档案。请恰好提供以下一项：

参数	类型	描述
slug	string	例如 "vitalik-buterin"、"circle"
ticker	string	例如 "ETH"、"SOL"（不区分大小写）

别名会自动解析（CZ → changpeng-zhao、Maker → makerdao、BSC → bnb-chain，……）。

get_explainer

获取规范的学院课程。请恰好提供以下一项：

参数	类型	描述
slug	string	课程 slug，例如 "what-is-a-blockchain"
topic	string	可解析到规范课程的主题关键词

署名

每个响应都包含结构化的 attribution 块：

{
  "data": { ... },
  "attribution": {
    "cite_url": "https://blockchainacademics.com/...",
    "as_of": "2026-04-19T12:34:56Z",
    "source_hash": "sha256:..."
  }
}

当你的 Agent 向用户展示 BCA 内容时，请通过 cite_url 标注出处。若上游未提供字段，其值会保留为 null，以便下游 Agent 检测来源信息是否缺失。

API 密钥

无需密钥即可试用。 未设置 BCA_API_KEY 时，服务会回退到内置的公共演示密钥，该密钥可解锁 10 个主打工具。请参见上文的演示版。

要使用完整的 105 个工具，请在 brain.blockchainacademics.com/signup 获取免费密钥（每月 2,000 次调用）。付费套餐可解锁由 Agent 支持的研究内容生成和专有链上指标。

在 MCP 客户端环境中设置 BCA_API_KEY。也可以选择覆盖 BCA_API_BASE（默认值为 https://api.blockchainacademics.com）。此外也支持 BCA_API_BASE_URL，以保持向后兼容。

错误

服务绝不会导致 stdio 进程崩溃。所有故障都会以 isError: true 的 MCP 响应和 JSON 正文呈现：

{ "error": { "code": "BCA_AUTH", "message": "..." } }

代码	含义
BCA_AUTH	BCA_API_KEY 无效（HTTP 401/403）
BCA_TIER_LOCKED	当前套餐的允许列表中不包含该工具（HTTP 403）。演示版使用 105 个工具中的 91 个时会出现此错误；错误消息中包含升级 URL。
BCA_RATE_LIMIT	超出速率限制（HTTP 429 — 请遵循 Retry-After）
BCA_UPSTREAM	BCA API 返回 5xx 或格式错误的 JSON
BCA_NETWORK	网络故障或超出 20s 超时
BCA_BAD_REQUEST	工具参数无效

开发

npm install
npm run build    # tsc -> dist/
npm test         # node:test smoke suite
npm run dev      # tsx src/index.ts (stdio)

提交前钩子

此仓库使用 pre-commit，在每次提交前执行格式检查、lint、密钥扫描和大文件限制检查。每次克隆后只需安装一次：

pip install pre-commit          # or: brew install pre-commit
pre-commit install              # wires .git/hooks/pre-commit
pre-commit run --all-files      # optional: lint the full tree now

pre-commit-config.yaml 中配置的钩子包括：prettier --check、eslint、gitleaks、detect-private-key、check-added-large-files（上限为 500KB）。

安全

有关漏洞报告、受支持的版本以及我们的 90 天协调披露政策，请参见 SECURITY.md。

许可证

MIT © 2026 Blockchain Academics