内容
<p align="center">
<img src="./public/Gemini_Generated_Image_v5uajdv5uajdv5ua.png" alt="恒星之鸦 — 热神经接口" width="100%">
</p>
# 恒星之鸦
基于 Cloudflare Workers 的远程 MCP 服务器，通过统一的恒星生态系统服务和技能目录，暴露 `搜索` 和 `执行` 两种工具。代理使用 `搜索` 来发现能力，然后调用 `执行`，并使用在动态 Worker 隔离环境中运行的 JavaScript，无需网络访问；服务调用通过主机侧适配器进行。
设计：[计划文档](./PLAN.md)。代码验证机制：[架构文档](./ARCHITECTURE.md)。
部署为 Cloudflare worker `stellar-raven-codemode`，网址为 https://raven.stellar.buzz — 工作程序/服务名称故意保留 `codemode` 后缀，尽管存储库名为 `stellar-raven`。
## 快速入门
```
服务器网址： https://raven.stellar.buzz （自 2026-07-02 起上线；别名：https://agents.stellar.buzz 仍然有效）
MCP 端点：POST https://raven.stellar.buzz/mcp （可流式 HTTP） # 或 https://agents.stellar.buzz/mcp
健康检查：GET /health
```
本地开发：`npm ci`，填充 `.dev.vars`，然后 `npm run dev`，并将客户端指向 `http://localhost:8787/mcp`。注意：`wrangler dev` 不会自动重新加载 `.dev.vars` 编辑 — 修改后请重新启动。
## 连接
在支持流式 HTTP 和 OAuth 的 MCP 客户端（Claude、Cursor 或任何兼容的客户端）中添加 `https://raven.stellar.buzz/mcp`。工作程序是其自己的 OAuth 授权服务器，并将登录委托给 WorkOS AuthKit；客户端应自动发现并完成该流程。
操作身份验证详细信息位于 [架构文档](./ARCHITECTURE.md) 和 [`research/auth-workos.md`](./research/auth-workos.md)。漏洞报告和研究人员范围位于 [安全文档](./SECURITY.md)。
## 开发
```
npm ci
npm run typecheck # tsc
npm test # vitest（离线；身份验证套件在 test/auth.test.ts）
npm run typegen # 在 wrangler.jsonc/.dev.vars 更改后重新生成 env.d.ts
```
对于本地 MCP 测试，填充 `.dev.vars`，运行 `npm run dev`，并将客户端指向 `http://localhost:8787/mcp`。编辑 `.dev.vars` 后重新启动 `wrangler dev`。
## 可观察性
结构化 JSON 事件（`src/observability.ts`）记录在 Workers 日志中；通过在每个沙盒运行周围启用自定义 `codemode.execute` 跨度来启用跟踪（Worker Loader 隔离环境未自动检测）。两者都可以在仪表板（Workers & Pages → Observability）或通过遥测查询 API 查询。整个界面的调查 — 定价、查询 API、OTel 导出、GraphQL 指标：`research/observability-cloudflare.md`。
## 许可证
[Apache-2.0](./LICENSE) © 2026 Tyler van der Hoeven — **除外** 供应商的第三方内容（`ecosystem-skills/skills/<source>/` 镜像和 `src/catalog/vendor/`），它们保留其上游许可证：请参阅 [`THIRD-PARTY-NOTICES.md`](./THIRD-PARTY-NOTICES.md)。值得注意的是，`openzeppelin-stellar` 技能子树是 AGPL-3.0。
