Maestro MCP 服务器

这是一个通过 Maestro API 平台与比特币互动的 Model Context Protocol (MCP) 服务器。提供了探索比特币区块链上的区块、交易、地址等工具。

---

快速链接

• 主网托管: https://xbt-mainnet.gomaestro-api.org/v0/mcp
• 测试网4托管: https://xbt-testnet.gomaestro-api.org/v0/mcp
• 需要 API 密钥: 获取您的 Maestro API 密钥
• 客户端示例: maestro-mcp-client-examples

---

开始使用

要求

• Node.js v20 或更高版本

安装与设置

# 安装依赖
npm install

# 构建项目
npm run build

# 复制并编辑环境变量文件
cp .env.example .env
# 编辑 .env 文件以添加您的 Maestro API 密钥和其他配置

运行服务器

npm run start:http

• 服务器将在您的 .env 文件中指定的端口上启动（默认：3000）。
• 访问 MCP 端点 http://localhost:<PORT>/mcp。

---

特性

• 🚀 可流式传输的 HTTP MCP 服务器 (规范)
• 🔑 API 密钥认证（参见 .env.example）
• 📦 多个 API：
  • 区块链索引器
  • 内存池监控
  • 市场价格
  • 钱包
  • 节点 RPC
• 🌐 支持的网络：
  • 主网：API_BASE_URL=https://xbt-mainnet.gomaestro-api.org/v0
  • 测试网4：API_BASE_URL=https://xbt-testnet.gomaestro-api.org/v0

---

API 参考与示例

• Maestro API 文档
• 客户端使用示例
• MCP: 通过大语言模型与比特币互动

---

服务器生成

此服务器使用 openapi-mcp-generator 生成：

npx openapi-mcp-generator --input openapi-merged.json --output ./ --force --transport streamable-http --port 3000

---

贡献与开发

欢迎贡献和功能请求！请：

• 清晰地记录您的更改
• 提交一个 拉取请求 或 打开一个问题

本地开发

• 使用 npm run dev 进行热重载（如果已配置）
• 使用 npm test 运行测试

---

支持

• 打开一个问题
• 加入 Discord

---

许可证

Apache 2.0