OmniForce

omniforce-mcp

已收录于 mcprush、Smithery 和 Official MCP Registry （io.github.rmb/omniforce-mcp）。

这是一个 Model Context Protocol（MCP）服务，适用于 OmniForce——一个 GEO 和 AI 搜索可见性 平台。它允许任何 MCP 客户端（Claude Desktop、Cursor、Cline、Continue 等） 审查网站对 AI 搜索的准备情况，并在聊天中查看已跟踪的提示词、竞争对手、 可见性运行记录和报告。

OmniForce 帮助品牌获得 ChatGPT、Perplexity、Gemini 和 Google AI Overviews 的引用，并跟踪 AI 引用及其随时间的衰减——omniforce.run。

工具

工具	身份验证	功能
omniforce_geo_scan	无	审查 URL 的 GEO/AEO 准备情况 → 基于证据的评分和发现。
omniforce_get_brand	API 密钥	租户的品牌资料。
omniforce_list_prompts	API 密钥	各答案引擎监控的查询。
omniforce_list_competitors	API 密钥	为租户跟踪的竞争对手。
omniforce_list_snapshots	API 密钥	最近的雷达运行记录（引用/可见性快照）。
omniforce_list_reports	API 密钥	可分享的可见性报告。
omniforce_account	API 密钥	套餐等级、包含的配额、当前用量和可用升级选项。
omniforce_upgrade	API 密钥	创建托管结账链接以升级套餐。

omniforce_geo_scan 无需密钥——安装服务后即可立即使用。其他工具会读取租户数据，因此需要 API 密钥。

快速开始

无需安装——使用 npx 运行：

// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
// Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "omniforce": {
      "command": "npx",
      "args": ["-y", "@omniforce/mcp"],
      "env": {
        "OMNIFORCE_API_KEY": "omk_your_key"
      }
    }
  }
}

OMNIFORCE_API_KEY 是可选的——省略 env 块即可只使用无需密钥的 omniforce_geo_scan 工具。请在 omniforce.run 创建密钥。

VS Code / Cline / Continue

{
  "mcpServers": {
    "omniforce": {
      "command": "npx",
      "args": ["-y", "@omniforce/mcp"],
      "env": { "OMNIFORCE_API_KEY": "omk_your_key" }
    }
  }
}

配置

环境变量	必需	默认值	用途
OMNIFORCE_API_KEY	租户工具必需	—	租户 API 密钥（omk_...）。
OMNIFORCE_API_BASE_URL	否	https://api.omniforce.run	覆盖 API 基础 URL。

从源代码运行

npm install
npm run build
node dist/index.js        # speaks MCP over stdio
npm test                  # vitest

远程（HTTP）端点

通过 Streamable HTTP 运行相同的工具，供注册表和托管客户端使用：

PORT=8080 OMNIFORCE_API_BASE_URL=https://api.omniforce.run npm run start:http
# or:
docker build -f Dockerfile.http -t omniforce-mcp-http . && docker run -p 8080:8080 omniforce-mcp-http

• POST /mcp — Streamable HTTP（MCP）
• GET /health、GET /.well-known/mcp/server-card.json

身份验证按每个请求进行：发送 Authorization: Bearer omk_...（或 x-api-key）即可 使用租户工具。匿名调用方可以使用无需密钥的 omniforce_geo_scan， 并受 IP/天速率限制（OMNIFORCE_ANON_DAILY_LIMIT，默认值为 10），同时会显示升级链接； 设置 MCP_CTA_FOOTER=off 可禁用页脚。

示例提示词

• “扫描 https://example.com 的 GEO，并总结最重要的 3 项修复建议。”
• “列出我跟踪的提示词和竞争对手。”
• “获取我最近 20 次可见性运行记录，并告诉我哪些地方的引用正在衰减。”
• “我当前使用什么套餐？还剩多少配额？”
• “我想再跟踪一个竞争对手——需要升级到什么套餐？”

套餐与升级

omniforce_geo_scan 免费且无需密钥。监控工具（提示词、 竞争对手、运行记录、报告、账户）会读取租户数据，适用于任何套餐。 如果请求需要更高级别的套餐，请调用 omniforce_account 查看当前 套餐和用量，然后调用 omniforce_upgrade 并指定套餐级别 （solo · starter · growth · scale），生成 Polar 结账链接，供 用户打开并付款。请参阅 omniforce.run。

安全

只读。该服务绝不会写入你的账户，并且只会将你的 API 密钥发送到 已配置的 OmniForce API 基础 URL。不会传输任何其他内容。

许可证

MIT — 请参阅 LICENSE。