Information
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获取比特币地址的 UTXOaddress: 比特币地址, 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: 铭文 IDrune_get获取特定符文的信息identifier: 符文名称或 IDrunes_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运行时。