内容
# 信号守护进程
**人工智能代理的叙事与信号情报** — 加密货币、人工智能和宏观经济。
一个简单但值得信赖的管道：它提供精选的 *叙事与信号*，而非原始数据，
并且 **安全失败** — 当它没有覆盖时，它会说明，而不是编造。
为机器而建，而非人眼。
- **API + MCP**: `https://api.signaldaemon.com`
- **文档**: https://signaldaemon.com/api
- **自助密钥**: `POST /v1/request-key` （无需注册）
此仓库是 **前门** — 快速入门、客户端配置和接口
合约。管道本身（来源、评分、精选）并非开源。
---
## 它是什么（和不是什么）
| 它是 | 它不是 |
|---|---|
| 跨源 **叙事收敛** + **资本与叙事分歧** | 价格/市场数据 API（使用 CoinGecko 等） |
| 覆盖约 14 个加密货币/人工智能/宏观经济领域 | 原始新闻信息流 |
| **安全失败** — “无覆盖”而非臆造 | 数据库查询事实 |
| 为代理（API/MCP）、代币成本无关、质量优先 | 面向人类的仪表板 |
## 快速入门
```bash
# 1 · 自助演示密钥（无需注册）
KEY=$(curl -s -X POST https://api.signaldaemon.com/v1/request-key | jq -r .key)
# 2 · 当天的排名叙事 + 衍生信号（缓存，立即）
curl -s https://api.signaldaemon.com/v1/narratives \
-H "x-api-key: $KEY" -d '{"limit":8}'
# 3 · 某个主题的干净叙事信息流
curl -s https://api.signaldaemon.com/v1/feed \
-H "x-api-key: $KEY" -d '{"query":"restaking","limit":8}'
```
## 从您的代理（MCP）连接
通过 Streamable HTTP 远程连接 MCP，使用 `x-api-key` 头部进行身份验证。
```bash
# Claude 代码
claude mcp add --transport http signaldaemon \
https://api.signaldaemon.com/mcp --header "x-api-key: <KEY>"
```
```yaml
# Hermes 代理 — ~/.hermes/config.yaml
mcp_servers:
signaldaemon:
url: "https://api.signaldaemon.com/mcp"
headers: { x-api-key: "<KEY>" }
```
更多客户端（Cursor、Cline）请参阅 [`examples/mcp-configs.md`](examples/mcp-configs.md)。
工具：`get_market_narratives(limit)` · `get_clean_feed(query, category, limit)` ·
`vet_trade(symbol, side)` — 所有注释均为 `readOnlyHint`。`vet_trade` 是
交易前门槛：向其提交候选交易，它会返回叙事层面的立场
（`support`/`caution`/`contradict`/`no_signal`）以及原因 + 置信度 — 它会审核，
但不推荐。
## 本地标准输入/输出桥
对于不支持远程 MCP 的客户端，此仓库附带一个薄 **标准输入/输出桥**
（[`mcp_server.py`](mcp_server.py)），通过托管 API 暴露相同的三个工具。
它不包含任何方法 — 只是一个客户端。
```bash
pip install mcp
export SIGNALDAEMON_API_KEY=cns_... # https://signaldaemon.com/console
python mcp_server.py
```
或使用 Docker：
```bash
docker build -t signaldaemon-mcp . && \
docker run -i -e SIGNALDAEMON_API_KEY=cns_... signaldaemon-mcp
```
桥启动并在没有密钥的情况下回答自省（`tools/list`)；
工具调用需要密钥。
## 接口
端点和响应字段合约（包括 `divergence` 模式）请参阅
[`API.md`](API.md)。字段名称稳定。
## 许可证
此仓库中的示例和文档：MIT（参见 [LICENSE](LICENSE)）。
信号守护进程服务和管道是专有的。
