内容
<div align="center">
# 奥里安智能代理工具包
**为AI智能代理提供的Celestia网络智能信息。** 奥里安每日分析的MCP服务器：异常信号、网络裁决、质押和DA指标、实时命名空间和验证者深入分析 — 每个数据都链接回其来源。
[](https://modelcontextprotocol.io)
[](https://celestia.org)
[](https://nodejs.org)
[](./LICENSE)
`https://orionlabsone.cc/mcp`
</div>
---
## 这是什么
奥里安持续监控Celestia主网，并发布每日机器撰写的简报：发生了什么，偏离基线是什么，以及为什么重要。该工具包通过[模型上下文协议](https://modelcontextprotocol.io)将该分析暴露给AI智能代理。
将其视为Celestia智能代理生态系统的**分析层**。它与知识库（回答“什么是CIP-21？”）和原始数据或交易工具包（列出blob或构建委托交易）一起使用。奥里安回答了一个不同的问题：**网络当前发生了什么，是正常的吗，我们如何到达这里？**
服务器返回的每个数字都带有`出处`链接到Celenium或Celestia LCD端点，以便智能代理可以引用其来源。服务器是**只读的**：没有任何钱包、密钥或交易。
## 工具
**今日 & 异常**
| 工具 | 回答的问题 |
|---|---|
| `get_daily_brief` | Celestia今天发生了什么？（设置`include_narrative`获取奥里安的书面文字） |
| `get_signals` | 今天或X日期有任何异常（信息/显著/关键）吗？ |
| `get_network_state` | 当前高度、DA容量、验证者、质押比率、Nakamoto系数、TIA价格 |
**趋势 & 历史**
| 工具 | 回答的问题 |
|---|---|
| `get_trends` | 自昨天/上周以来发生了什么变化？（日和周环比变化） |
| `get_metric_history` | 在N天内绘制一个指标（费用、blob、价格、质押比率...） |
| `list_reports` | 存档中存在哪些每日报告？ |
| `get_report` | 给定日期的完整报告 |
| `search_reports` | 存档中最后一次提到“eclipse”或“block time”是什么时候？ |
**实时深入分析** （直接来自Celenium）
| 工具 | 回答的问题 |
|---|---|
| `get_top_namespaces` | 哪些rollups当前向Celestia发布最多的数据？ |
| `get_namespace` | 命名空间的详细信息：大小、blob数量、最后活动 |
| `get_top_validators` | 按权益排序的最大验证者 - 昵称、佣金、监禁状态 |
## 资源 & 提示
除了工具之外，服务器还暴露了MCP**资源**，智能代理可以读取或订阅：
- `orion://latest` — 最近的每日报告
- `orion://reports` — 存档索引
- `orion://report/{date}` — 按日期归档的任何报告
… 以及现成的**提示**来指导智能代理：
- `daily_celestia_briefing` — 生成一个有根据的、来源引用的每日简报
- `rollup_da_check` — 调查谁主导了blob空间和当前的DA成本环境
## 什么被视为信号
奥里安的检测器是**事件驱动的，而不是状态驱动的** — 持久的主导命名空间或每日稳定利用率不会产生信号，因此您看到的是实际发生的变化：
- **DA利用率 & 费用** — 与最近的每日基线相比，每个区块的容量和费用
- **Blob容量z分数** — 数据发布的统计峰值/下降
- **命名空间转移** — 只有当DA领导者改变或其份额发生重大变化时
- **质押 & 集中度** — 绑定比率变化、Nakamoto系数变化、新监禁
- **市场 & 协议** — 显著的TIA价格变动、活跃的治理提案、新celestia-app发布
每个每日简报都由LLM叙述者编写，并经过自动**引用检查** — 每个数字在发布前都会与结构化数据进行验证。
## 快速开始 —托管端点（无需安装）
MCP服务器运行在 **`https://orionlabsone.cc/mcp``.
**Claude 代码**
```bash
claude mcp add --transport http orion https://orionlabsone.cc/mcp
```
**Cursor** — 添加到 `.cursor/mcp.json` （如果您克隆了此仓库，则已包含）：
```json
{ "mcpServers": { "orion": { "url": "https://orionlabsone.cc/mcp" } } }
```
**VS Code** — 添加到 `.vscode/mcp.json`:
```json
{ "servers": { "orion": { "type": "http", "url": "https://orionlabsone.cc/mcp" } } }
```
**Claude Desktop / Codex / Windsurf / Cline / 任何仅限stdio的客户端** — 使用 [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) 桥接：
```json
{
"mcpServers": {
"orion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://orionlabsone.cc/mcp"]
}
}
}
```
每个客户端的逐步指南： [Claude Code](docs/claude-code.md) · [Claude Desktop](docs/claude-desktop.md) · [Cursor](docs/cursor.md) · [Codex](docs/codex.md) · [VS Code](docs/vscode.md)
## 快速开始 — 克隆 & 聊天
```bash
git clone https://github.com/orioninfra/orion-agent-kit
cd orion-agent-kit
npm install
claude # Claude Code 自动获取 .mcp.json
```
然后直接提问：
> "Celestia今天有任何异常吗？" · "自昨天以来Celestia发生了什么变化？" · "哪些rollups当前向Celestia发布最多的数据？" · "验证者集合的集中度如何？" · "存档最后一次提到区块时间是什么时候？"
捆绑的 `/brief` 和 `/signals` 命令封装了两个最常见的查询。
## 自己运行服务器
```bash
npm install
npm run start # 127.0.0.1:8791/mcp上的流式HTTP
npm run start:stdio # stdio传输（用于本地MCP客户端）
npm run smoke # 针对实时API的工具端到端检查
npm run typecheck # 类型检查源代码
```
环境： `PORT` （默认 `8791`）， `HOST` （默认 `127.0.0.1`）， `ORION_API_BASE` （默认 `https://orionlabsone.cc`）， `CELENIUM_BASE` （默认 `https://api-mainnet.celenium.io/v1`，由深入分析工具使用）。
## REST，无MCP
底层API是纯JSON，可以直接使用或通过函数调用与 [OpenAPI规范](https://orionlabsone.cc/openapi.json) 一起使用：
| 端点 | 返回 |
|---|---|
| `GET /api/latest` | 今日完整报告 |
| `GET /api/reports` | 存档索引 |
| `GET /api/reports/{date}` | 指定日期的完整报告 |
| `GET /api/rss` | 简报作为RSS源 |
## 如何组合
```
AI智能代理（Claude / GPT / 任意MCP客户端）
│ MCP — 只读分析工具、资源和提示
▼
orion-agent-kit ──► 奥里安每日分析（orionlabsone.cc/api）
│ │ 每个数据都链接到其来源
│ ▼
│ Celestia LCD · 市场数据
└──────────► Celenium API （实时命名空间和验证者深入分析）
```
## 许可证
[Apache-2.0](./LICENSE)，版权归Orion Labs所有。问题、想法或您希望存在的工具：请提交问题。
