Omnicost

Omnicost MCP サーバー

スペイン、米国、EUの建設単価を、出典と日付とともにModel Context Protocol経由でAIエージェントに提供します。

Omnicostは、建設コストのカタログおよび見積もりツールです。公共入札やサプライヤーカタログなど208の情報源から、資材、労務、機材の単価を収集し、各価格に出典と確認日を記録しています。カタログには約81,000件の価格付き項目が登録されており、スペイン、米国、EUを中心に網羅しています。このリポジトリには、ホスト型MCPサーバーの公開情報として、MCPレジストリ用のserver.jsonと、そのまま使えるクライアント設定が含まれています。

サーバー自体はOmnicostがホストしています。このリポジトリからインストールしたり、実行したりする必要はありません。

エンドポイント	https://omnicost.com/api/mcp
トランスポート	Streamable HTTP
認証	Authorization: Bearer <organization API key>
レジストリ名	com.omnicost/catalog
ウェブサイト	https://omnicost.com

APIキーを取得する

接続するには、Omnicostの無料ワークスペースを作成し、組織APIキーを生成します。Freeプランにはキーが1つ含まれています。

1. https://omnicost.com/en でサインアップし、ワークスペースを作成します。
2. https://omnicost.com/dashboard/mcp を開き、組織APIキーを作成します。
3. 以下に示すように、MCPクライアントの設定に追加します。

キーなしで/api/mcpにリクエストすると、Omnicostワークスペースの組織APIキーを求める401が返されます。

ツール

ツール	機能
search_catalog	カタログをセマンティック検索します。自由入力の検索クエリ（q）、省略可能なlimit（最大25件）、省略可能なregionを指定します。該当する項目と、価格の中央値およびベンダー数を返します。
get_item	1つの項目（ci_... ID）を取得し、ベンダー別の内訳と、出典付きの最近の価格を返します。
list_categories	カタログの最上位カテゴリを一覧表示します。
get_decomposition	項目のBC3レシピを返します。単位あたりの資材、労務、機材の構成要素が含まれます。

有用な結果を得るには、スペイン、米国、EUの価格が付いた項目を検索してください。

クライアントの設定

プレースホルダーを組織APIキーに置き換えてください。キーをバージョン管理に含めないでください。

Cursor

~/.cursor/mcp.jsonまたはプロジェクト内の.cursor/mcp.json（examples/cursor.mcp.json）：

{
  "mcpServers": {
    "omnicost": {
      "url": "https://omnicost.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:OMNICOST_API_KEY}"
      }
    }
  }
}

VS Code

.vscode/mcp.json（examples/vscode.mcp.json）。VS Codeでは初回にキーの入力を求められ、キーは自動的に保存されます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "omnicost-key",
      "description": "Omnicost API key",
      "password": true
    }
  ],
  "servers": {
    "omnicost": {
      "type": "http",
      "url": "https://omnicost.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:omnicost-key}"
      }
    }
  }
}

Claude Desktop

Claude Desktopはリモートサーバーとの通信にmcp-remoteを使用するため、Node.jsをインストールする必要があります。claude_desktop_config.jsonに次の内容を追加します（examples/claude-desktop.json）。

{
  "mcpServers": {
    "omnicost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://omnicost.com/api/mcp",
        "--header",
        "Authorization:Bearer ${OMNICOST_API_KEY}"
      ],
      "env": {
        "OMNICOST_API_KEY": "<your key>"
      }
    }
  }
}

その他のクライアント

Streamable HTTPに対応したクライアントでhttps://omnicost.com/api/mcpを指定し、AuthorizationヘッダーでキーをBearerトークンとして送信してください。

料金

Freeプランには、MCP用の組織APIキーが含まれています。Omnicost Pro（週額$9、月額$29、または年額$290）では、月間100,000件のリクエストでAPIとMCPを利用できます。詳しくは https://omnicost.com/en/pricing をご覧ください。

詳細

• REST APIドキュメント： https://omnicost.com/en/docs/api
• 開発者向けページ： https://omnicost.com/en/developers
• サーバーカード： https://omnicost.com/.well-known/mcp.json
• サポート： [email protected]

ライセンス

このリポジトリの内容はMIT Licenseに基づいて公開されています。OmnicostはIpita LLCの製品です。