stellar-pulse-mcp

Name: stellar-pulse-mcp
Author: markankamaransheogarat-sys

本地服务

github.com/markankamaransheogarat-sys金融数据01 周前更新

代码仓库

关于 stellar-pulse-mcp

stellar-pulse-mcp 是面向 AI 助手的只读 MCP 服务，用于查询 Stellar 网络活动、资产、账户、市场和 DeFi。它提供结构化公共数据并检查资产可信度，不会签名或提交交易。

主要功能

01账本状态与费用水平
02资产数据与仿冒警告
03活跃资产排名
04SDEX 订单簿深度与价差
05账户余额与可支用 XLM
06Stellar DeFi TVL 与协议

适用场景

01检查 Stellar 网络状态和费用
02评估资产发行方及同名资产
03查看 SDEX 流动性与价差
04计算账户可支用的 XLM

MCP 相关

向 MCP 客户端提供 Stellar 分析工具，涵盖网络状态、资产详情、热门资产、SDEX 订单簿、账户信息和 DeFi 数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "markankamaransheogarat-sys-stellar-pulse": {
      "command": "npx",
      "args": [
        "-y",
        "stellar-pulse-mcp"
      ]
    }
  }
}

启动命令npx -y stellar-pulse-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmstellar-pulse-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

stellar-pulse-mcp

通过 Model Context Protocol，为 AI 助手提供只读的 Stellar 分析。询问 Claude（或任何 MCP 客户端）有关 Stellar 网络健康状况和费用、资产质量、DEX 订单簿、账户和 DeFi 的信息，并从公共 API 获取结构化答案。无需 API 密钥。无需签名。不会发起交易。

现有的 Stellar MCP 服务专注于构建和发送交易，或开发 Soroban 合约。这个服务则关注工作的另一面：了解网络上正在发生什么，并发现不可信之处。

工具	可以回答的问题
`stellar_network_status`	最新账本（年龄、交易数、失败率、协议版本、基础储备）和费用水平
`stellar_asset`	资产的价格、供应量、持有者、7 天交易量、评级和仿冒警告（资产标识可为 `XLM`、`USDC` 或 `CODE-ISSUER`）
`stellar_top_assets`	按交易量、交易数、付款数、持有者数量或 StellarExpert 评级排列的最活跃资产
`stellar_orderbook`	一对资产的 SDEX 订单簿：最佳买价/卖价、中间价、价差，以及 1% 和 5% 范围内的深度
`stellar_account`	余额、扣除储备和未成交订单后的可用 XLM、签名者、阈值、回收标记、近期付款
`stellar_defi`	来自 DefiLlama 的 Stellar DeFi 数据：TVL、链排名、领先协议、按类别划分的 TVL

提示词示例：

“Stellar 网络现在拥堵吗？费用情况如何？”
“这是正版 USDC 吗？”（提供 USDC-G...；它会检查发行方、域名、持有者和评级）
“SDEX 上的 XLM/USDC 订单簿有多深？价差是多少？”
“这个账户实际可以花多少 XLM？”
“Stellar 上最大的 DeFi 协议有哪些？哪些正在增长？”

安全细节为何重要

许多资产使用相同的代码。 任何人都可以发行名为 USDC 的代币。如果你只提供代码，stellar_asset 会选取交易量最大的资产，告知你有多少其他资产使用相同代码，并标记没有已验证主页域名、评级较低、持有者极少或没有交易量的发行方。
拒绝处理密钥。 以 S 开头的值会在任何网络调用之前立即被拒绝，也不会回显。此服务只需要以 G 开头的公开地址。
可用 XLM 是计算得出的，并非猜测：(2 + subentries + sponsoring - sponsored) x base reserve，再减去未成交订单中锁定的 XLM；储备值取自最新账本。

安装

需要 Node.js 20 或更高版本。最快的方法是使用 npx，无需克隆：

Claude Code

claude mcp add stellar-pulse -- npx -y stellar-pulse-mcp

在 Windows 上，请从 cmd 运行（PowerShell 会吞掉 --），并使用包装命令 npx，以便 Claude Code 能够启动它：

claude mcp add stellar-pulse -- cmd /c npx -y stellar-pulse-mcp

添加 -s user，即可在每个文件夹中使用，而不仅限于当前项目。

Claude Desktop

{
  "mcpServers": {
    "stellar-pulse": {
      "command": "npx",
      "args": ["-y", "stellar-pulse-mcp"]
    }
  }
}

在 Windows 上，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "stellar-pulse-mcp"]。

已发布到 npm，并收录于官方 MCP Registry，名称为 io.github.markankamaransheogarat-sys/stellar-pulse-mcp。

若要改为从源代码运行：

git clone https://github.com/markankamaransheogarat-sys/stellar-pulse-mcp.git
cd stellar-pulse-mcp
npm install
npm run build
node dist/index.js

详情

数据源：Horizon（账本、费用、账户、订单簿）、StellarExpert（资产统计数据和评级）以及 DefiLlama（TVL）。仅限主网。
**单位：**Horizon 金额使用十进制单位；StellarExpert 提供的供应量和交易量以 stroops 为单位，并会进行换算（1 XLM = 10,000,000 stroops）。
**单个数据源不可用不算失败。**如果某个工具会组合多个数据源，它会根据可访问的数据源作答，并在 errors 字段中列出不可用的数据源。
**缓存：**账本级数据缓存 3 到 4 秒，StellarExpert 缓存 60 秒，DefiLlama 缓存 5 分钟，以避免频繁请求免费套餐。同时发出的相同请求会共用一次调用。
深度统计 SDEX 订单簿每侧最优的 100 档。不包括流动性池和 Soroban DEX。
**不构成财务建议。**公开数据快照，可能有几秒到几分钟的延迟。

开发

npm run typecheck   # tsc --noEmit over src and tests
npm test            # vitest, all HTTP mocked
npm run build       # compile to dist/
npm run smoke       # live check against the real APIs (needs a build first)

src/sources/* 各自对接一个 API，src/tools/* 存放逻辑并各自注册一个 MCP 工具，src/stellar.ts 验证账户 ID 和资产引用，src/http.ts 是共享客户端（超时、有限重试、TTL 缓存）。

同系列项目 crypto-pulse-mcp 用于查询跨交易所价格、永续合约资金费率和稳定币流动情况。