openharness-mcp 0.0.1

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "openharness-mcp",
+  "version": "0.0.1",
+  "description": "OTel MCP server — exposes query_metrics, query_logs, query_traces to agents.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "openharness-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "openharness-core": "workspace:*"
+  },
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * @openharness/mcp
+ *
+ * An MCP server that wraps the local OTel stack and exposes three tools to agents:
+ *
+ *   query_metrics(promql: string)   → VictoriaMetrics instant query
+ *   query_logs(logql: string)       → VictoriaLogs query
+ *   query_traces(traceql: string)   → Tempo TraceQL search
+ *
+ * Agents can verify their own work without knowing local ports or query syntax specifics.
+ * Ports are read from .open-harness.json with fallback to DEFAULT_PORTS.
+ *
+ * Usage:
+ *   openharness mcp start          (via CLI)
+ *   npx @openharness/mcp           (standalone)
+ */
+
+export { startMcpServer } from './server.js';

package/src/server.ts

@@ -0,0 +1,30 @@
+import { DEFAULT_PORTS, type HarnessConfig } from 'openharness-core';
+
+export interface McpServerOptions {
+  config?: HarnessConfig;
+}
+
+/**
+ * Starts the MCP server. Reads port config from .open-harness.json if available,
+ * falling back to DEFAULT_PORTS.
+ *
+ * Exposes three MCP tools:
+ *   - query_metrics  → PromQL against VictoriaMetrics
+ *   - query_logs     → LogQL against VictoriaLogs
+ *   - query_traces   → TraceQL against Tempo
+ */
+export async function startMcpServer(options: McpServerOptions = {}): Promise<void> {
+  const ports = {
+    ...DEFAULT_PORTS,
+    ...options.config?.ports,
+  };
+
+  // TODO: implement MCP server using @modelcontextprotocol/sdk
+  // Tools: query_metrics, query_logs, query_traces
+  // Each tool proxies to the corresponding local OTel backend.
+
+  console.log('openharness mcp server starting');
+  console.log(`  VictoriaMetrics → http://localhost:${ports.victoriametrics}`);
+  console.log(`  VictoriaLogs    → http://localhost:${ports.victorialogs}`);
+  console.log(`  Tempo           → http://localhost:${ports.tempo}`);
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}