@qune-tech/ocds-mcp 0.3.0

package/README.md

@@ -0,0 +1,104 @@
+<!-- mcp-name: io.github.qune-tech/ocds-mcp -->
+
+# @qune-tech/ocds-mcp
+
+MCP server for German public procurement data (OCDS). Connects your AI assistant to the [Vergabe Dashboard](https://vergabe-dashboard.qune.de) API for semantic search, tender matching, and company profile management.
+
+Company profiles never leave your machine. GDPR-compliant by design.
+
+## Quick Start
+
+```bash
+npx @qune-tech/ocds-mcp --api-key sk_live_YOUR_KEY_HERE
+```
+
+### Get an API key
+
+Sign up at [vergabe-dashboard.qune.de](https://vergabe-dashboard.qune.de) and create an API key (MCP or Enterprise plan required).
+
+## Configure your AI client
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ocds": {
+      "command": "npx",
+      "args": ["-y", "@qune-tech/ocds-mcp", "--api-key", "sk_live_YOUR_KEY_HERE"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add `.mcp.json` to your project root:
+
+```json
+{
+  "mcpServers": {
+    "ocds": {
+      "command": "npx",
+      "args": ["-y", "@qune-tech/ocds-mcp", "--api-key", "sk_live_YOUR_KEY_HERE"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Settings > MCP Servers > Add:
+
+- Command: `npx`
+- Args: `-y @qune-tech/ocds-mcp --api-key sk_live_YOUR_KEY_HERE`
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_text` | Semantic search across all tenders |
+| `list_releases` | Filter and browse tenders by month, CPV code, category, value range |
+| `get_release` | Full tender details by OCID |
+| `get_index_info` | Database statistics and connectivity check |
+| `create_company_profile` | Create a matching profile for your company |
+| `update_company_profile` | Update an existing profile |
+| `get_company_profile` | View profile details |
+| `list_company_profiles` | List all your profiles |
+| `delete_company_profile` | Delete a profile |
+| `match_tenders` | Match a profile against all tenders with semantic similarity |
+
+## How It Works
+
+The npm package downloads the correct platform-native binary on install. No Node.js runtime dependency for the actual MCP server.
+
+```
+LLM <--stdio--> ocds-mcp (local binary)
+                   |  Local: company profiles + sentence embedder
+                   |  Remote: searches, release queries
+                   +--HTTPS--> Vergabe Dashboard API
+```
+
+- Company profiles are stored locally (never leave your machine).
+- Text embeddings are computed locally (multilingual-e5-small ONNX model, ~118 MB, auto-downloaded on first run).
+- Only embedding vectors are sent to the API for search and matching.
+
+## Supported Platforms
+
+| Platform | Architecture |
+|----------|-------------|
+| Linux | x86_64 |
+| macOS | Apple Silicon (ARM64) |
+| Windows | x86_64 |
+
+## Requirements
+
+- An API key from [vergabe-dashboard.qune.de](https://vergabe-dashboard.qune.de)
+- ~200 MB disk space for the ONNX model (auto-downloaded on first run)
+- Internet connection to reach the API
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const binary = process.platform === "win32" ? "ocds-mcp.exe" : "ocds-mcp";
+const binaryPath = path.join(__dirname, "bin", binary);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    `ocds-mcp binary not found at ${binaryPath}\n` +
+      `Run "npm rebuild @qune-tech/ocds-mcp" to trigger the download.`
+  );
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start ocds-mcp: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@qune-tech/ocds-mcp",
+  "version": "0.3.0",
+  "description": "MCP server for German public procurement data (OCDS). Semantic search, tender matching, and company profile management.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qune-tech/ocds-mcp"
+  },
+  "homepage": "https://vergabe-dashboard.qune.de",
+  "keywords": [
+    "mcp",
+    "ocds",
+    "procurement",
+    "tenders",
+    "vergabe"
+  ],
+  "mcpName": "io.github.qune-tech/ocds-mcp",
+  "bin": {
+    "ocds-mcp": "index.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "index.js",
+    "postinstall.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}

package/postinstall.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+"use strict";
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const os = require("os");
+
+const VERSION = require("./package.json").version;
+const REPO = "qune-tech/ocds-mcp";
+const BASE_URL = `https://github.com/${REPO}/releases/download/v${VERSION}`;
+
+const PLATFORMS = {
+  "linux-x64": {
+    asset: "ocds-mcp-linux-x86_64.tar.gz",
+    extracted: "ocds-mcp-linux-x86_64",
+    binary: "ocds-mcp",
+  },
+  "darwin-arm64": {
+    asset: "ocds-mcp-macos-arm64.tar.gz",
+    extracted: "ocds-mcp-macos-arm64",
+    binary: "ocds-mcp",
+  },
+  "win32-x64": {
+    asset: "ocds-mcp-windows-x86_64.zip",
+    extracted: "ocds-mcp-windows-x86_64.exe",
+    binary: "ocds-mcp.exe",
+  },
+};
+
+function getPlatformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const request = (url) => {
+      https
+        .get(url, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            request(res.headers.location);
+            return;
+          }
+          if (res.statusCode !== 200) {
+            reject(new Error(`Download failed: HTTP ${res.statusCode} for ${url}`));
+            return;
+          }
+          const chunks = [];
+          res.on("data", (chunk) => chunks.push(chunk));
+          res.on("end", () => resolve(Buffer.concat(chunks)));
+          res.on("error", reject);
+        })
+        .on("error", reject);
+    };
+    request(url);
+  });
+}
+
+function extractTarGz(buffer, destDir) {
+  const archivePath = path.join(destDir, "archive.tar.gz");
+  fs.writeFileSync(archivePath, buffer);
+  execSync(`tar xzf "${archivePath}" -C "${destDir}"`, { stdio: "ignore" });
+  fs.unlinkSync(archivePath);
+}
+
+function extractZip(buffer, destDir) {
+  const archivePath = path.join(destDir, "archive.zip");
+  fs.writeFileSync(archivePath, buffer);
+  // Use PowerShell on Windows, unzip on Unix
+  if (process.platform === "win32") {
+    execSync(
+      `powershell -Command "Expand-Archive -Force '${archivePath}' '${destDir}'"`,
+      { stdio: "ignore" }
+    );
+  } else {
+    execSync(`unzip -o "${archivePath}" -d "${destDir}"`, { stdio: "ignore" });
+  }
+  fs.unlinkSync(archivePath);
+}
+
+async function main() {
+  const key = getPlatformKey();
+  const info = PLATFORMS[key];
+
+  if (!info) {
+    console.error(
+      `Unsupported platform: ${key}\n` +
+        `Supported: ${Object.keys(PLATFORMS).join(", ")}\n` +
+        `You can build from source: https://github.com/${REPO}#building-from-source`
+    );
+    process.exit(1);
+  }
+
+  const binDir = path.join(__dirname, "bin");
+  const binaryPath = path.join(binDir, info.binary);
+
+  // Skip download if binary already exists (cached)
+  if (fs.existsSync(binaryPath)) {
+    console.log(`ocds-mcp binary already exists at ${binaryPath}`);
+    return;
+  }
+
+  const url = `${BASE_URL}/${info.asset}`;
+  console.log(`Downloading ocds-mcp v${VERSION} for ${key}...`);
+  console.log(`  ${url}`);
+
+  let buffer;
+  try {
+    buffer = await download(url);
+  } catch (err) {
+    console.error(`Failed to download ocds-mcp binary: ${err.message}`);
+    console.error(
+      `\nYou can download it manually from:\n  https://github.com/${REPO}/releases/tag/v${VERSION}`
+    );
+    process.exit(1);
+  }
+
+  fs.mkdirSync(binDir, { recursive: true });
+
+  if (info.asset.endsWith(".tar.gz")) {
+    extractTarGz(buffer, binDir);
+  } else if (info.asset.endsWith(".zip")) {
+    extractZip(buffer, binDir);
+  }
+
+  // Rename extracted binary to canonical name
+  const extractedPath = path.join(binDir, info.extracted);
+  if (fs.existsSync(extractedPath) && info.extracted !== info.binary) {
+    fs.renameSync(extractedPath, binaryPath);
+  }
+
+  // Make binary executable on Unix
+  if (process.platform !== "win32") {
+    fs.chmodSync(binaryPath, 0o755);
+  }
+
+  if (!fs.existsSync(binaryPath)) {
+    console.error(
+      `Binary not found after extraction. Expected: ${binaryPath}\n` +
+        `Please report this issue at https://github.com/${REPO}/issues`
+    );
+    process.exit(1);
+  }
+
+  console.log(`ocds-mcp v${VERSION} installed to ${binaryPath}`);
+}
+
+main();