Orbit Sentinel — Space Regulatory Filings

Orbit Sentinel MCP 服务

面向 Orbit Sentinel 的 MCP（Model Context Protocol）服务 — 来自 FCC、ITU、UNOOSA 和 FAA-AST 的 95 万多份空间监管申报文件， 可通过 Claude Desktop、Claude Code、Cursor 或任意 MCP 客户端查询。

需要 API 密钥。Beta 访问权限：https://console.viventine.com。

此服务是公共 REST API 的轻量开源（MIT）客户端 — 仅有 9 个 Go 文件，运行前易于审查。可通过 stdio 在本地运行，也可以跳过安装，直接让客户端连接托管的远程端点（如下所示）。

安装

远程（无需安装）

最简单的方式 — 无需二进制文件，也无需更新。让任意支持 HTTP 的 MCP 客户端连接到：

https://orbit-sentinel.viventine.com/mcp

传输方式为 Streamable HTTP（无状态）。有两种身份验证方式：

OAuth（推荐） — 在浏览器中使用 Viventine 账号登录；无需复制或保存 密钥。在 Claude Code 中：

claude mcp add --transport http orbit-sentinel https://orbit-sentinel.viventine.com/mcp

然后运行 /mcp -> orbit-sentinel -> authenticate。浏览器会打开登录 和授权页面；Claude Code 会保存令牌并自动刷新。在 claude.ai / Claude Desktop 中 将其添加为自定义连接器，操作方式相同（Settings -> Connectors -> Add custom connector -> 粘贴 URL -> 登录）。

API 密钥 — 如果你更愿意使用静态密钥（或者客户端不支持 OAuth）， 请将控制台密钥作为 bearer token 传入：

claude mcp add --transport http orbit-sentinel \
  https://orbit-sentinel.viventine.com/mcp \
  --header "Authorization: Bearer <your-key>"

可在 https://console.viventine.com 获取密钥 / Beta 访问权限。

通用 MCP 客户端 — 任意 Streamable HTTP 客户端均可通过 OAuth 2.1 （RFC 9728 受保护资源发现）或 Authorization: Bearer <key> 标头连接。发送 Python 默认 urllib User-Agent（Python-urllib/x.y）的请求会在我们的边缘节点被拦截，并返回 HTTP 403；请设置自己的 User-Agent，或使用 requests 或 httpx。未经身份验证的 tools/call 请求会收到带有 WWW-Authenticate 标头的 HTTP 401 响应，该标头指向受保护资源的元数据，OAuth 客户端据此发现身份验证流程；initialize 和 tools/list 仍可公开访问。对于仅支持 stdio 的客户端，可通过 npx mcp-remote https://orbit-sentinel.viventine.com/mcp 桥接。

Claude Desktop（一键安装）

下载 orbit-sentinel-mcp.mcpb 并双击 — Claude Desktop 会安装扩展并提示输入 API 密钥。包含 macOS（通用版）、Linux 和 Windows 二进制文件。

Homebrew（macOS — 推荐）

brew install --cask viventine-space/tap/orbit-sentinel-mcp

安装到 $(brew --prefix)/bin/orbit-sentinel-mcp，自动处理 quarantine 标记，并可通过 brew upgrade 升级。

手动下载

从最新版本 下载适用于你平台的压缩包，然后：

tar -xzf orbit-sentinel-mcp_*.tar.gz
mkdir -p ~/bin && mv orbit-sentinel-mcp ~/bin/

仅限 macOS — 二进制文件尚未公证，因此需要清除一次隔离标记：

xattr -d com.apple.quarantine ~/bin/orbit-sentinel-mcp

Windows：解压并记下 orbit-sentinel-mcp.exe 的完整路径。

从源代码构建

go install github.com/viventine-space/orbit-sentinel-mcp@latest

配置

服务会读取两个环境变量：

变量	用途
MCP_API_URL	Orbit Sentinel API 基础 URL（https://orbit-sentinel.viventine.com）
MCP_API_KEY	你从控制台获取的 API 密钥

Claude Desktop — 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （Windows：%APPDATA%\Claude\claude_desktop_config.json），使用二进制文件的绝对 路径（~ 不会展开）：

{
  "mcpServers": {
    "orbit-sentinel": {
      "command": "/absolute/path/to/orbit-sentinel-mcp",
      "env": {
        "MCP_API_URL": "https://orbit-sentinel.viventine.com",
        "MCP_API_KEY": "<your-key>"
      }
    }
  }
}

Claude Code — 一条命令：

claude mcp add orbit-sentinel \
  --env MCP_API_URL=https://orbit-sentinel.viventine.com \
  --env MCP_API_KEY=<your-key> \
  -- ~/bin/orbit-sentinel-mcp

重启客户端；Orbit Sentinel 工具（research、search_filings、 get_entity_profile、…）会显示在工具菜单中。

发布（维护者）

打标签并推送 — GitHub Actions 会构建并发布所有平台的版本：

git tag v0.x.y && git push origin v0.x.y

资源文件名保持版本稳定（orbit-sentinel-mcp_<os>_<arch>.tar.gz），因此 releases/latest/download/... URL 始终会提供最新构建版本。

Claude Desktop 安装包（orbit-sentinel-mcp.mcpb）由发布工作流打包并上传 — 清单模板位于 mcpb/manifest.json （打包时会从标签填入其 version）。

然后重复发布到 Glama 的流程 — 它不会从 GitHub 自动更新，并且会根据上方的徽章评定质量分数。在 Dockerfile 管理页面 上，已保存的构建规范应该会保留（构建步骤会安装 Go 并运行 go build； 占位参数需要一个虚拟的 MCP_API_KEY 才能通过环境变量架构校验）— 点击 Build，然后使用新版本点击 Make Release。目前需要手动操作； 可以考虑在下个发布周期集成 Glama API。