Satstream MCP服务器
一种模型上下文协议服务器,通过Satstream API启用对比特币区块链数据的查询,包括地址信息、交易详情、内存池统计信息以及序数/符文数据。
服务介绍
Satstream MCP 服务器
一个提供访问 Satstream 比特币数据 API 的模型上下文协议 (MCP) 服务器。
设置
要安装依赖项:
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 密钥。您可以按照以下步骤获取:
- 访问 Satstream 文档
- 注册一个账户
- 从您的仪表板生成 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运行时。