Obelinf

io.github.Obelinf由 GitHub 账号 Obelinf 发布v1.0.1更新于 Nov 2, 2026

MCP server for Obelinf, the network documentation platform. Sites, racks, devices, IPs, VLANs.

已验证Streamable HTTP可网页运行数据库云端与基础设施开发者工具

概览

AI 生成的概览

Obelinf 的托管 MCP 服务器，让助手搜索、读取并更新站点、机架、设备、IP、VLAN 等网络文档数据。

可以做什么
  • 对整个基础设施清单做跨资源全文搜索
  • 列出、查看、创建、更新和删除站点、机架与设备
  • 管理 IPAM：子网、IP 地址、VLAN 与 VRF
  • 维护端口与端点之间的布线和 MAC 地址清单
  • 管理关联基础设施的联系人与供应商
  • 查看每次变更的审计记录，含操作者与字段级差异
适用场景
当你的网络与数据中心记录存放在 Obelinf 中，并希望助手据此回答问题或进行可追溯的编辑时适用，例如查询某台设备位于哪个机架、哪些 IP 尚未分配。
运行要求
远程 Streamable HTTP 端点，无需本地安装。需要 Obelinf 账号与组织，以及通过 Authorization Bearer 头传入的 API 密钥，或 ChatGPT 使用的 OAuth 授权流程。密钥在控制台创建，可选只读或完全访问范围。速率限制为每分钟 100 次请求。
安装前请注意
API 密钥仅显示一次，且可访问组织内的记录，需妥善保管。完全访问密钥允许助手创建、更新和删除站点、机架、设备、子网、IP、VLAN、VRF、线缆、MAC 地址与联系人。建议先用只读密钥并审阅差异，再谨慎升级权限。所有写入都会记入组织变更日志。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Obelinf，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Obelinf MCP Server

Hosted Model Context Protocol server for Obelinf, the network and infrastructure documentation platform. Connect AI agents like Claude, Cursor, or Codex to your infrastructure records and let them query, answer, and update sites, racks, devices, IP address space, and cabling through one endpoint.

This repository does not contain the server's source code. It holds the MCP listing metadata, connection docs, the changelog for the MCP surface, and the public issue tracker.

Quick start

  1. Sign in at obelinf.com and open your organization. MCP is available on all plans, including the free Personal plan.
  2. Create an API key: Dashboard → API Keys → create a key and choose a scope: Read Only or Full Access. Copy it when shown; it is only displayed once.
  3. Add the server to your MCP client. Your endpoint is https://api.obelinf.com/mcp. The organization is selected from your authenticated Obelinf account.

ChatGPT

ChatGPT uses OAuth. Add the MCP endpoint and complete the Obelinf approval flow when prompted. Google and GitHub remain the available Obelinf sign-in methods; ChatGPT receives a short-lived, organization-scoped MCP token after approval.

Cursor (plugin)

Install the Obelinf/mcp repository as a Cursor plugin from the Cursor directory. Set OBELINF_API_KEY once under Plugins → Configure and the server connects automatically. No manual JSON editing needed.

To add it manually instead, use the config below.

Claude Code

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

Claude Desktop, Cursor, and other JSON-configured clients

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

VS Code (.vscode/mcp.json)

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

Other MCP clients: point them at the URL above over Streamable HTTP and send the API key as an Authorization: Bearer header.

Endpoint details

PropertyValue
Endpointhttps://api.obelinf.com/mcp
TransportMCP Streamable HTTP
AuthenticationOAuth for ChatGPT; scoped API keys for other clients
Rate limit100 requests per minute
AvailabilityAll plans
Tools52

Tools

GroupToolsDescription
SearchsearchCross-resource full-text search across your inventory
Siteslist_sites, get_site, create_site, update_site, delete_sitePhysical locations and data center sites
Rackslist_racks, get_rack, create_rack, update_rack, delete_rackRack inventory, units, and positions
Deviceslist_devices, get_device, create_device, update_device, delete_deviceServers, switches, appliances, and VMs
Subnetslist_subnets, get_subnet, create_subnet, update_subnet, delete_subnetIPAM subnets and prefixes
IP addresseslist_ip_addresses, get_ip_address, create_ip_address, update_ip_address, delete_ip_addressAssigned and free addresses
VLANslist_vlans, get_vlan, create_vlan, update_vlan, delete_vlanVLAN groups and IDs
VRFslist_vrfs, get_vrf, create_vrf, update_vrf, delete_vrfVirtual routing and forwarding instances
Cableslist_cables, get_cable, create_cable, update_cable, delete_cableCabling between ports and endpoints
MAC addresseslist_mac_addresses, get_mac_address, create_mac_address, update_mac_address, delete_mac_addressMAC inventory and assignments
Contactslist_contacts, get_contact, create_contact, update_contact, delete_contactPeople and vendors tied to infrastructure
Changeloglist_changelogAudit trail of every change, with actor and field-level diffs

Permissions

  • Read Only keys can use all read and search tools. Write tools return an error.
  • Full Access keys can read and write. Every write is recorded in the organization changelog with attribution and field-level diffs, so agent edits are as reviewable as manual ones.

Start agents on a Read Only key, review their diffs, then promote to Full Access deliberately.

Support

来源：README.md，提交 faeb862

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分