内容
# 星轨哨兵 MCP 服务器
MCP（模型上下文协议）服务器，用于 [星轨哨兵](https://viventine.com) —
从 FCC、ITU、UNOOSA 和 FAA-AST 提取的 419,000+ 条空间监管备案，
可从 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端查询。
API 密钥是必需的。测试访问权限：<https://console.viventine.com>.
服务器是公共 REST API 的一个薄、开源（MIT）stdio 客户端 —
五个 Go 文件，在运行前易于审计。
## 安装
### Homebrew（macOS — 推荐）
```bash
brew install --cask viventine-space/tap/orbit-sentinel-mcp
```
安装到 `$(brew --prefix)/bin/orbit-sentinel-mcp`，为您处理隔离标志，
并使用 `brew upgrade` 升级。
### 手动下载
从 [最新版本](https://github.com/viventine-space/orbit-sentinel-mcp/releases/latest) 下载您平台的存档，
然后：
```bash
tar -xzf orbit-sentinel-mcp_*.tar.gz
mkdir -p ~/bin && mv orbit-sentinel-mcp ~/bin/
```
仅限 macOS — 二进制文件尚未经过 notarization，因此请一次性清除隔离标志：
```bash
xattr -d com.apple.quarantine ~/bin/orbit-sentinel-mcp
```
Windows：解压并记下 `orbit-sentinel-mcp.exe` 的完整路径。
### 从源代码构建
```bash
go install github.com/viventine-space/orbit-sentinel-mcp@latest
```
## 配置
服务器读取两个环境变量：
| 变量 | 用途 |
|---|---|
| `MCP_API_URL` | 星轨哨兵 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`），使用二进制文件的绝对路径（`~` 不会展开）：
```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** — 一个命令：
```bash
claude mcp add orbit-sentinel \
--env MCP_API_URL=https://orbit-sentinel.viventine.com \
--env MCP_API_KEY=<your-key> \
-- ~/bin/orbit-sentinel-mcp
```
重启您的客户端；星轨哨兵工具（`research`、`search_filings`、`get_entity_profile`，…）将出现在工具菜单中。
## 发布（维护者）
标记并推送 — GitHub Actions 构建并发布所有平台：
```bash
git tag v0.x.y && git push origin v0.x.y
```
资产名称是版本稳定的（`orbit-sentinel-mcp_<os>_<arch>.tar.gz`），
因此 `releases/latest/download/...` URL 始终提供最新的构建。
