OmniForce

omniforce-mcp

mcprush、Smithery、および 公式 MCP レジストリ （io.github.rmb/omniforce-mcp）に掲載されています。

GEO と AI 検索での可視性を高めるプラットフォーム、OmniForce 用の Model Context Protocol（MCP）サーバーです。任意の 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 は省略可能です。キー不要の omniforce_geo_scan ツールのみを使う場合は、env ブロックを省略してください。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 回の可視性の実行結果を取得し、引用が減少している箇所を教えてください。」
• 「現在のプランと、残りの割り当て量を教えてください。」
• 「競合他社をもう 1 社追跡したいのですが、どのプランにアップグレードすればよいですか？」

プランとアップグレード

omniforce_geo_scan は無料で、キーも不要です。モニタリングツール（プロンプト、 競合、実行、レポート、アカウント）はテナントデータを読み取り、どのプランでも 利用できます。リクエストに上位プランが必要な場合は、omniforce_account を呼び出して現在の プランと使用状況を確認し、次にプラン （solo · starter · growth · scale）を指定して omniforce_upgrade を呼び出すと、 ユーザーが開いて支払いできる Polar のチェックアウトリンクが生成されます。 omniforce.run をご覧ください。

セキュリティ

読み取り専用です。サーバーがお客様のアカウントに書き込むことはなく、API キーは設定済みの OmniForce API ベース URL にのみ送信されます。 それ以外の情報は送信されません。

ライセンス

MIT — LICENSE をご覧ください。