Satstream MCP Server

Satstream MCP 服务

一个 Model Context Protocol（MCP）服务，可访问 Satstream 比特币数据 API。

设置

安装依赖：

bun install

使用 API 密钥运行：

export SATSTREAM_API_KEY="your-api-key-here"
bun run index.ts

或者将 API 密钥作为命令行参数传入：

bun run index.ts your-api-key-here

关于 Satstream

Satstream 是一项全面的比特币区块链 API 服务，可访问实时区块链数据，包括交易、地址、区块，以及 Ordinals 铭文和 Runes 代币等专门数据。

获取 API 密钥

要使用此 MCP 服务，你需要 Satstream API 密钥。你可以通过以下方式获取：

1. 访问 Satstream 文档
2. 注册账户
3. 在控制面板中生成 API 密钥

免费套餐提供基本功能访问权限，但有速率限制；付费套餐则提供更高的速率限制和更多功能。

可用的 MCP 函数

以下 MCP 函数可用于查询比特币数据：

地址函数

函数名称	描述	参数
address_get	获取比特币地址的详细信息	address：比特币地址
address_balance_get	获取比特币地址的余额	address：比特币地址
address_deltas_get	获取地址的交易历史记录	address：比特币地址，以及可选的分页参数
address_validate	验证比特币地址	address：比特币地址
address_outputs_get	获取比特币地址的 UTXO	address：比特币地址，type：可选的 UTXO 类型筛选条件
address_rune_deltas_get	获取地址的符文代币历史记录	address：比特币地址，以及可选的分页参数

区块链函数

函数名称	描述	参数
block_get	根据哈希或高度获取区块信息	identifier：区块哈希或高度
blockchain_info	获取当前区块链统计数据和网络信息	random_string：可选的虚设参数
transaction_get	获取交易详情	txid：交易 ID

内存池函数

函数名称	描述	参数
mempool_info_get	获取内存池统计数据	random_string：可选的虚设参数
mempool_transactions_get	列出未确认交易	可选的分页参数

Ordinals 和 Runes 函数

函数名称	描述	参数
ordinals_inscription_get	获取 Ordinals 铭文数据	inscription_id：铭文 ID
rune_get	获取特定符文的信息	identifier：符文名称或 ID
runes_latest_get	获取最新的符文（前 100 个）	random_string：可选的虚设参数
runes_page_get	获取指定页的符文	page：页码

使用示例

获取地址信息

address_get({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

验证比特币地址

address_validate({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

获取区块信息

block_get({ identifier: "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f" })

获取区块链统计数据

blockchain_info({ random_string: "dummy" })

获取地址余额

address_balance_get({ address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" })

按类型筛选并获取地址的 UTXO

address_outputs_get({ 
  address: "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  type: "cardinal"
})

获取特定符文的信息

rune_get({ identifier: "UNCOMMON•GOODS" })

获取最新的符文

runes_latest_get({ random_string: "dummy" })

MCP 集成

此服务旨在与 Cursor 或其他支持 Model Context Protocol 的环境搭配使用。有关函数的详细说明和使用指南，请参阅 function-descriptions.json。

此项目使用 Bun 创建。Bun 是一个快速的一体化 JavaScript 运行时。