AI导哈

比特币序数MCP服务器

一个完整的比特币序数MCP服务器，提供24种工具，涵盖铭文、符文、BRC-20代币、收藏品、稀有聪和市集数据，并集成了Hiro、Ordiscan和Magic Eden API的智能缓存和自动故障转移功能。

  • by ExpertVagabond
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ExpertVagabond/ordinals-mcp

使用说明

普通mcp

最完整的比特币Ordinals MCP服务器。 24种工具，涵盖铭文、符文、BRC-20代币、收藏品、稀有卫星和市场数据。通过智能缓存和自动故障转移聚合Hiro、Ordiscan和Magic Eden API。

唯一的替代方案（ordiscan-mcp）有25个npm下载，覆盖了表面的一小部分。此服务器是生产级选项。

安装

npx ordinals-mcp@latest

或全局安装：

npm install -g ordinals-mcp
ordinals-mcp

配置

添加到MCP配置(claude_desktop_config.json 或 ~/.mcp.json):

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": ["-y", "ordinals-mcp@latest"],
      "env": {
        "HIRO_API_KEY": "your-key",
        "ORDISCAN_API_KEY": "your-key"
      }
    }
  }
}

至少一个 HIRO_API_KEY 或 ORDISCAN_API_KEY 是必需的。两者都是免费的：

提供者 速率限制 获取密钥
广 （初级） 500转/分 platform.hiro.so
Ordiscan （回退） -- ordiscan.com/docs/api
魔法伊甸园 （可选） -- 文档

工具（24）

铭文（5）

工具 描述 关键参数
get_inscription 按ID或编号列出完整的铭文细节 id
search_inscriptions 使用过滤器（类型、mime、日期范围）搜索铭文 query, filters
get_inscription_content 铭文的原始内容 id
get_inscription_transfers 铭文的转移历史记录 id
get_inscription_traits 铭文的特征和属性 id

地址查询（4）

工具 描述 关键参数
get_address_inscriptions 所有由比特币地址持有的铭文 address
get_brc20_balances 地址的BRC-20令牌余额 address
get_rune_balances 地址的Rune余额 address
get_address_rare_sats 地址持有罕见的satoshi address

符文（6）

工具 描述 关键参数
get_rune_info 详细的符文元数据（蚀刻、供应、持有者） rune
list_runes 列出所有符文，并进行分页和排序 offset, limit
get_rune_holders 特定符文的顶级持有者 rune
get_rune_activity 符文最近的活动（造币、转移、焚烧） rune
get_rune_market_info 市场数据——底价、成交量、房源 rune
get_rune_unlock_date 时间锁定符文的解锁/可用日期 rune

BRC-20（3）

工具 描述 关键参数
get_brc20_token 令牌详细信息（供应、限制、持有者、部署信息） ticker
get_brc20_activity BRC-20代币的最新活动 ticker
get_brc20_holders BRC-20代币的顶级持有者 ticker

收藏（3）

工具 描述 关键参数
get_collection_info 收藏元数据、底价、数量 slug
get_collection_inscriptions 收藏中的铭文 slug
get_collection_listings 收藏的活跃市场列表 slug

周六与交易（3）

工具 描述 关键参数
get_sat_info Sat稀有性、名称和铭文历史 sat_number
get_tx_inscriptions 比特币交易中的铭文 txid
get_tx_runes 在比特币交易中运行操作 txid

为什么是这个？

  • 24种工具，全覆盖。 铭文、符文、BRC-20、藏品、稀有卫星和市场数据。MCP没有其他条例涵盖所有六类。
  • 具有自动故障切换功能的Multi-API。 聚合Hiro（初级，500 RPM）、Ordiscan（后备）和Magic Eden（市场）。如果一个API速率限制，请求会自动路由到下一个。
  • 智能缓存。 根据数据类型调整TTL——卫星稀有性（24小时）、铭文元数据（500万）、收藏信息（200万）、余额（100万）、市场列表（30秒）。在停机期间，过时的缓存是最后的手段。

建筑

Request --> Cache (TTL + ETag)
  |--> HIT: return cached
  |--> MISS:
      |--> Hiro (primary, 500 RPM)
      |     |--> Success: cache + return
      |     |--> Rate limited: Ordiscan (fallback) --> Stale cache (last resort)
      |--> Magic Eden (marketplace-specific)

环境变量

变量 必填 描述
HIRO_API_KEY 是* Hiro API密钥(自由)
ORDISCAN_API_KEY 是* Ordiscan API密钥(自由)
MAGIC_EDEN_API_KEY 否 更高的市场利率限制
CACHE_TTL_SECONDS 否 默认缓存TTL（默认值：300）

*至少需要一个。

发展

git clone https://github.com/ExpertVagabond/ordinals-mcp.git
cd ordinals-mcp
npm install
npm run build
npm run inspector    # MCP Inspector for testing

许可证

麻省理工学院-- 紫松鼠传媒

相关 MCP