ocds-mcp

用途

ocds-mcp 是一个本地 MCP（Model Context Protocol）服务器，用于德国公共采购数据搜索。它把 AI 助手（Claude、GPT 等）连接到 Vergabe Dashboard API，以便进行语义搜索、招标匹配和企业画像管理。

获取 API 密钥：在 vergabe-dashboard.qune.de 注册并创建 API 密钥。API 密钥要求有效的 Pro 计划（每月 99 欧元）；本地服务器本身免费且开源，API 网关用于密钥签发。

安装方式：

npx -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE

配置 AI 客户端：

Claude Desktop：编辑 claude_desktop_config.json。使用二进制时，命令为 vergabe-mcp，参数为 --api-key sk_live_YOUR_KEY_HERE。
Claude Code：在项目根目录添加 .mcp.json。
Cursor：Settings → MCP Servers → Add；参数为 -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE。
LM Studio：Settings → MCP → Add Server；点击 + Add Server 并选择 STDIO；命令为二进制完整路径（例如 /usr/local/bin/vergabe-mcp），参数为 --api-key sk_live_YOUR_KEY_HERE。在聊天中选择支持工具调用的模型并启用 vergabe 服务器。LM Studio 需要支持工具调用的模型（例如 Qwen 2.5、Mistral、Llama 3.1+）；较小的模型可能无法可靠使用全部 11 个工具，建议 7B+。

请将 sk_live_YOUR_KEY_HERE 替换为实际 API 密钥。也可以通过 VERGABE_API_KEY 环境变量传入密钥。

保留在本地机器上的内容：企业画像文本、搜索查询文本、CPV 兴趣领域、位置。
API 可见的内容：嵌入向量、读取的 OCID、使用的筛选值以及 API 密钥。这些会透露商业兴趣（关注的行业、采购方、价值区间、招标），但不包含底层文本。嵌入向量是派生的、假名化的表示——属于最小化而非消除。
企业画像（名称、描述、CPV 兴趣、位置）存储在本地 SQLite 数据库中，不会离开本地网络。
文本嵌入在本地使用多语言 ONNX 模型（multilingual-e5-small，384 维）计算。搜索查询使用 query: 前缀并发送到 POST /api/v1/search/vector；画像描述使用 passage: 前缀并发送到 POST /api/v1/match/vector。
只有嵌入向量（384 个浮点数）、获取的 OCID、筛选值和 API 密钥会发送到 API。

首次运行模型下载：

需要将本地 AI 助手接入德国公共采购数据，进行语义搜索、招标匹配和企业画像管理的用户。也提供托管替代方案：仅希望从 AI 助手进行搜索的用户可使用托管 MCP 连接器（OAuth 登录，无需安装）。

MIT — 见 LICENSE。