semcode-mcp 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# semcode-mcp (npm wrapper)
+
+Thin `npx` wrapper for the [semantic-code-mcp](https://github.com/huawang1258/semantic-code-mcp) Python MCP server (published as `semcode-mcp`). It launches the PyPI package via `uvx` (or a `pip`-installed console script).
+
+**Prerequisite**: [uv](https://docs.astral.sh/uv/getting-started/installation/) or `pip install semcode-mcp`.
+
+## MCP client config
+
+```json
+{
+  "mcpServers": {
+    "semantic-code": {
+      "command": "npx",
+      "args": ["-y", "semcode-mcp"],
+      "env": {
+        "VOYAGE_API_KEY": "your-voyage-key"
+      }
+    }
+  }
+}
+```
+
+Full docs: https://github.com/huawang1258/semantic-code-mcp

package/bin.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * semcode-mcp npm 薄壳：把 MCP server 启动透传给 Python 包。
+ *
+ * 解析顺序：
+ *   1. uvx semcode-mcp      （推荐：uv 自动管理隔离环境）
+ *   2. semcode-mcp          （已 pip install 的 console script）
+ * 都不可用时打印安装指引退出。
+ *
+ * stdio 直通（MCP 协议走 stdin/stdout），信号与退出码原样转发。
+ */
+"use strict";
+
+const { spawnSync, spawn } = require("node:child_process");
+
+const PYPI_PACKAGE = "semcode-mcp";
+
+function exists(cmd) {
+  const probe = process.platform === "win32" ? "where" : "which";
+  return spawnSync(probe, [cmd], { stdio: "ignore" }).status === 0;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  let file = null;
+  let fileArgs = [];
+
+  if (exists("uvx")) {
+    file = "uvx";
+    fileArgs = [PYPI_PACKAGE, ...args];
+  } else if (exists(PYPI_PACKAGE)) {
+    file = PYPI_PACKAGE;
+    fileArgs = args;
+  } else {
+    process.stderr.write(
+      [
+        `semcode-mcp: no Python runtime launcher found.`,
+        ``,
+        `Install one of:`,
+        `  1. uv (recommended): https://docs.astral.sh/uv/getting-started/installation/`,
+        `     then this wrapper runs: uvx ${PYPI_PACKAGE}`,
+        `  2. pip install ${PYPI_PACKAGE}`,
+        ``,
+      ].join("\n")
+    );
+    process.exit(1);
+  }
+
+  const child = spawn(file, fileArgs, { stdio: "inherit" });
+  for (const sig of ["SIGINT", "SIGTERM"]) {
+    process.on(sig, () => child.kill(sig));
+  }
+  child.on("exit", (code, signal) => {
+    process.exit(signal ? 1 : code ?? 0);
+  });
+  child.on("error", (err) => {
+    process.stderr.write(`semcode-mcp: failed to launch ${file}: ${err.message}\n`);
+    process.exit(1);
+  });
+}
+
+main();

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "semcode-mcp",
+  "version": "0.1.0",
+  "description": "Semantic code search MCP server: Tree-sitter AST chunking + voyage-code-3 embeddings + hybrid retrieval (sqlite-vec + FTS5 + RRF) + Voyage rerank-2.5 + call graph expansion. Thin npx wrapper that launches the Python package via uvx.",
+  "bin": {
+    "semcode-mcp": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "semantic-search",
+    "code-search",
+    "rag",
+    "tree-sitter",
+    "embeddings"
+  ],
+  "author": "huawang1258",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/huawang1258/semantic-code-mcp.git"
+  },
+  "homepage": "https://github.com/huawang1258/semantic-code-mcp#readme"
+}