blocklens-mcp-server

blocklens-mcp-server

用于 Blocklens 比特币链上分析的 MCP（Model Context Protocol）服务。将你的 AI Agent 接入 127 项链上指标，这些指标直接根据原始区块链数据计算得出——无需 API 封装，也不会有延迟。

快速开始

远程访问（无需安装）

直接连接到托管的端点——无需安装软件包，也无需本地配置：

Claude.ai（浏览器）： 设置 → 连接器 → 添加 → URL：https://mcp.blocklens.co

Claude Desktop / Cursor / Windsurf（通过 mcp-remote）：

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.blocklens.co"]
    }
  }
}

任何 MCP HTTP 客户端： 向 https://mcp.blocklens.co 发送 POST 请求（Streamable HTTP 传输）

本地安装

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"],
      "env": {
        "BLOCKLENS_API_KEY": "blk_your_key_here"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor / Windsurf

在 MCP 配置文件（.cursor/mcp.json）中添加：

{
  "blocklens": {
    "command": "npx",
    "args": ["-y", "blocklens-mcp-server"],
    "env": {
      "BLOCKLENS_API_KEY": "blk_your_key_here"
    }
  }
}

演示模式（无需 API 密钥）

无需 API 密钥即可使用基础层级指标的 60 天历史数据。前往 blocklens.co/api-keys 获取 API 密钥以使用完整功能。

可用工具（15 个）

工具	描述
list_metrics	列出全部 127 项可用指标及其类别和层级
search_metrics	按关键字搜索指标
get_metric	获取单项指标的完整定义
get_categories	列出指标类别及数量
get_prices	BTC 日线 OHLC、市值、成交量、回撤、已实现波动率（1W–1Y）
get_holder_supply	LTH/STH 供应量细分、流通供应量
get_holder_valuation	已实现市值/价格、MVRV、热力市值、Delta 市值、平衡价格、投资者市值
get_holder_profit	NUPL、已实现/未实现盈亏、SOPR——LTH/STH 细分（Pro 层级）
get_cohort_metrics	年龄群组供应量、已实现市值、已实现价格（12 个年龄区间）
get_utxo_history	按年龄群组划分的 UTXO 集合
get_coindays	销毁币天数、活跃度、封存度、休眠度、休眠流量
get_blockchain	区块高度、已挖区块数
get_cycle_performance	按低点、历史最高点和减半时间点编制索引的周期表现
get_latest_metrics	所有类别的最新快照
render_chart	将任意指标渲染为带注释和模板的 PNG 图表

指标覆盖范围（共 127 项）

市场数据（27 项指标）

价格、OHLC、成交量、市值、从历史最高点回撤、6 种已实现波动率时间窗口（1W、2W、1M、3M、6M、1Y）、周期表现，以及从低点、历史最高点和减半时间点开始追踪的各个周期。

供应量（16 项指标）

流通供应量、LTH/STH 供应量、成本基础分布热力图，以及用于 HODL Waves 分析的 12 个年龄群组供应量（<24h 至 10y+）。

估值（41 项指标）

已实现市值、已实现价格、MVRV（总体 + LTH/STH）、热力市值、Delta 市值、平均市值、平衡价格、投资者市值、市值/热力市值比率，以及 24 个年龄群组的已实现价格和已实现市值。

盈利能力（12 项指标）

NUPL、未实现/已实现盈亏、SOPR——每项均提供总体、LTH 和 STH 细分。

币天（11 项指标）

销毁币天数（CDD）、二元 CDD、供应量调整后的 CDD、活跃度、封存度、休眠度、休眠流量、净币天数、累积币天数、转移价格、转移量。

ETF 分析（11 项指标）

BTC 持仓总量、AUM、净流入/累计流入、累计资金流、ETF 已实现价格、美国现货 ETF 已实现价格、美国现货累计资金流、BTC 市占率、美国 BTC 持仓量、ETF 平均溢价。

区块链（2 项指标）

区块高度、已挖区块数。

图表渲染

render_chart 工具会在对话中内联生成 PNG 图表。

快速示例：

render_chart({ metric: "price", days: 365 })
render_chart({ template: "mvrv_ratio" })
render_chart({ metrics: ["lth_supply", "sth_supply"], style: "area" })
render_chart({ metric: "dormancy_flow", overlay: "price" })
render_chart({ template: "realized_volatility", days: 730 })

注释——参考线和区域：

render_chart({
  metric: "lth_mvrv",
  reference_lines: [
    { "y": 3.5, "label": "Overheated", "stroke": "#ef4444", "dash": "3 3" }
  ],
  reference_areas: [
    { "y1": 0, "y2": 0.85, "label": "Undervalued", "fill": "#22c55e", "fill_opacity": 0.15 }
  ]
})

示例提示词

• “当前 Bitcoin 的 MVRV 比率是多少？它反映了怎样的估值？”
• “显示已实现波动率——短期波动率是否高于长期波动率？”
• “绘制过去 2 年的休眠流量图，并叠加价格走势”
• “比较过去 90 天 LTH 和 STH 的供应趋势”
• “长期休眠的币是否正在苏醒？检查活跃度和 CDD”
• “显示每次减半以来的周期表现——我们是否符合历史模式？”
• “当前 NUPL 水平是多少？市场处于亢奋还是恐惧状态？”

访问层级

层级	历史数据	指标	每日请求数
Demo（无密钥）	60 天	基础（等级 0）	不限
Pro（$50/月）	不限	全部等级 0–1	10,000
Enterprise（$900/月）	不限	全部等级 0–2	100,000

链接

• 远程 MCP 端点
• Blocklens
• 完整文档
• 指标参考
• API 参考
• 获取 API 密钥
• MCP 协议

许可证

MIT