Omnicost

Omnicost MCP 服务

通过模型上下文协议，AI Agent 可以获取西班牙、美国和欧盟的建筑工程单价及其来源和日期。

Omnicost 是建筑成本目录和估算工具。它从公共招标、供应商目录等 208 个来源收集材料、人工和设备的单价，并为每个价格记录来源和采集日期。目录包含约 81,000 项有价格的条目，覆盖范围以西班牙、美国和欧盟最为全面。此代码库提供托管 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 密钥。免费套餐包含一个密钥。

1. 在 https://omnicost.com/en 注册并创建工作区。
2. 打开 https://omnicost.com/dashboard/mcp 并创建组织 API 密钥。
3. 按照下方示例，将密钥添加到 MCP 客户端配置中。

向 /api/mcp 发送不含密钥的请求会收到 401 响应，提示提供 Omnicost 工作区的组织 API 密钥。

工具

工具	功能
search_catalog	对目录进行语义搜索。接受自由文本查询（q）、可选的 limit（最多 25）和可选的 region。返回匹配条目及其中位价格和供应商数量。
get_item	获取单个条目（ci_... ID）及其供应商明细和近期价格，并附上各价格的来源。
list_categories	列出目录的顶级类别。
get_decomposition	返回条目的 BC3 配方：每单位所需的材料、人工和机械组成。

如需获得有用结果，请查询在西班牙、美国或欧盟定价的条目。

客户端设置

将占位符替换为组织 API 密钥。请勿将密钥提交到版本控制中。

Cursor

~/.cursor/mcp.json 或项目中的 .cursor/mcp.json（示例）：

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

VS Code

.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（示例）：

{
  "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 令牌形式发送密钥。

定价

免费套餐包含用于 MCP 的组织 API 密钥。Omnicost Pro（每周 $9、每月 $29 或每年 $290）包含 API 和 MCP 访问权限，每月可发出 100,000 次请求。详见 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 许可证发布。Omnicost 是 Ipita LLC 的产品。