Obelinf

Obelinf MCP 服务

面向 Obelinf 的托管式 Model Context Protocol 服务。将 Claude、Cursor 或 Codex 等 AI Agent 连接到你的基础设施记录，通过一个端点查询、回答和更新站点、机架、设备、IP 地址空间及布线信息。

此仓库不包含服务的源代码。它包含 MCP 列表元数据、连接文档、MCP 接口的更新日志，以及公开问题跟踪器。

• 网站：https://obelinf.com
• API 文档：https://obelinf.com/docs/api/
• MCP 功能概览：https://obelinf.com/features/ai-infrastructure-documentation/

快速开始

1. 登录 obelinf.com 并打开你的组织。所有套餐均可使用 MCP，包括免费的 Personal 套餐。
2. 创建 API 密钥：控制面板 → API Keys → 创建密钥并选择权限范围：Read Only 或 Full Access。密钥显示时请复制；它只会显示一次。
3. 将服务添加到你的 MCP 客户端。端点为 https://api.obelinf.com/mcp。组织将根据你已通过身份验证的 Obelinf 账户进行选择。

ChatGPT

ChatGPT 使用 OAuth。添加 MCP 端点，并在出现提示时完成 Obelinf 授权流程。Obelinf 仍支持通过 Google 和 GitHub 登录；授权后，ChatGPT 会收到一个短时有效、限定组织范围的 MCP 令牌。

Cursor（插件）

从 Cursor 目录 将 Obelinf/mcp 仓库安装为 Cursor 插件。在 Plugins → Configure 下设置一次 OBELINF_API_KEY，服务便会自动连接。无需手动编辑 JSON。

如需手动添加，请改用下方配置。

Claude Code

claude mcp add --transport http obelinf "https://api.obelinf.com/mcp" \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop、Cursor 和其他通过 JSON 配置的客户端

{
  "mcpServers": {
    "obelinf": {
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "obelinf": {
      "type": "http",
      "url": "https://api.obelinf.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

其他 MCP 客户端：通过 Streamable HTTP 连接到上述 URL，并在 Authorization: Bearer 标头中传入 API 密钥。

端点详情

属性	值
端点	https://api.obelinf.com/mcp
传输方式	MCP Streamable HTTP
身份验证	ChatGPT 使用 OAuth；其他客户端使用限定权限范围的 API 密钥
速率限制	每分钟 100 个请求
可用性	所有套餐
工具	52

工具

分组	工具	说明
搜索	search	对你的库存进行跨资源全文搜索
站点	list_sites, get_site, create_site, update_site, delete_site	实体位置和数据中心站点
机架	list_racks, get_rack, create_rack, update_rack, delete_rack	机架库存、机架单位和位置
设备	list_devices, get_device, create_device, update_device, delete_device	服务器、交换机、设备和虚拟机
子网	list_subnets, get_subnet, create_subnet, update_subnet, delete_subnet	IPAM 子网和前缀
IP 地址	list_ip_addresses, get_ip_address, create_ip_address, update_ip_address, delete_ip_address	已分配和空闲地址
VLAN	list_vlans, get_vlan, create_vlan, update_vlan, delete_vlan	VLAN 组和 ID
VRF	list_vrfs, get_vrf, create_vrf, update_vrf, delete_vrf	虚拟路由和转发实例
线缆	list_cables, get_cable, create_cable, update_cable, delete_cable	端口和端点之间的布线
MAC 地址	list_mac_addresses, get_mac_address, create_mac_address, update_mac_address, delete_mac_address	MAC 库存和分配情况
联系人	list_contacts, get_contact, create_contact, update_contact, delete_contact	与基础设施相关的人员和供应商
更新日志	list_changelog	所有变更的审计记录，包含操作者和字段级差异

权限

• 只读密钥可以使用所有读取和搜索工具。写入工具会返回错误。
• 完全访问密钥可以读取和写入。每次写入都会记录在组织变更日志中，并标注操作者和字段级差异，因此 Agent 的编辑与人工编辑一样可供审查。

让 Agent 使用只读密钥启动，审查其差异后，再谨慎地将密钥提升为完全访问权限。

支持

• 有关 MCP 界面的错误报告和功能请求：提交问题
• 套餐、定价和企业协议：联系销售