普通mcp
](https://www.npmjs.com/package/ordinals-mcp)  ](https://nodejs.org) 
最完整的比特币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许可证
麻省理工学院-- 紫松鼠传媒