@weapp-vite/mcp 1.1.0 → 1.1.1

package/README.md

@@ -11,7 +11,7 @@
 - 文档/变更记录资源暴露
 - 调试/改造提示词模板
 
-默认通过 `stdio` 运行，适合接入任意 MCP Client。
+默认通过 `stdio` 运行，适合接入任意 MCP Client，也支持 `streamable-http`。
 
 ## 启动
 
@@ -19,6 +19,22 @@
 pnpm --filter @weapp-vite/mcp start
 ```
 
+也可以在 Node 脚本里直接调用：
+
+```ts
+import { startWeappViteMcpServer } from '@weapp-vite/mcp'
+
+const handle = await startWeappViteMcpServer({
+  workspaceRoot: process.cwd(),
+  transport: 'streamable-http',
+  host: '127.0.0.1',
+  port: 3088,
+  endpoint: '/mcp',
+})
+
+await handle.close?.()
+```
+
 ## 主要 Tools
 
 - `workspace_catalog`: 输出 `weapp-vite / wevu / wevu-compiler` 目录、版本、脚本

package/dist/index.d.mts

@@ -85,6 +85,25 @@ declare function createWeappViteMcpServer(options?: CreateServerOptions): Promis
     workspaceRoot: string;
 }>;
 
+declare const DEFAULT_MCP_HOST = "127.0.0.1";
+declare const DEFAULT_MCP_PORT = 3088;
+declare const DEFAULT_MCP_ENDPOINT = "/mcp";
+interface StartMcpServerOptions extends CreateServerOptions {
+    transport?: 'stdio' | 'streamable-http';
+    host?: string;
+    port?: number;
+    endpoint?: string;
+    unref?: boolean;
+    quiet?: boolean;
+    onReady?: (message: string) => void;
+}
+interface McpServerHandle {
+    transport: 'stdio' | 'streamable-http';
+    close?: () => Promise<void>;
+}
+declare function startStdioServer(options?: CreateServerOptions): Promise<void>;
+declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
+
 declare function formatJson(value: unknown): string;
 declare function normalizeErrorMessage(error: unknown): string;
 declare function toToolResult(data: unknown, text?: string): {
@@ -108,7 +127,5 @@ declare function resolveWorkspaceRoot(start?: string): string;
 declare function assertInsideRoot(root: string, targetPath: string): string;
 declare function resolveSubPath(root: string, relativePath: string): string;
 
-declare function startStdioServer(): Promise<void>;
-
-export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, toToolError, toToolResult };
-export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, SearchMatch };
+export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };
+export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, McpServerHandle, SearchMatch, StartMcpServerOptions };

package/dist/index.d.ts

@@ -85,6 +85,25 @@ declare function createWeappViteMcpServer(options?: CreateServerOptions): Promis
     workspaceRoot: string;
 }>;
 
+declare const DEFAULT_MCP_HOST = "127.0.0.1";
+declare const DEFAULT_MCP_PORT = 3088;
+declare const DEFAULT_MCP_ENDPOINT = "/mcp";
+interface StartMcpServerOptions extends CreateServerOptions {
+    transport?: 'stdio' | 'streamable-http';
+    host?: string;
+    port?: number;
+    endpoint?: string;
+    unref?: boolean;
+    quiet?: boolean;
+    onReady?: (message: string) => void;
+}
+interface McpServerHandle {
+    transport: 'stdio' | 'streamable-http';
+    close?: () => Promise<void>;
+}
+declare function startStdioServer(options?: CreateServerOptions): Promise<void>;
+declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
+
 declare function formatJson(value: unknown): string;
 declare function normalizeErrorMessage(error: unknown): string;
 declare function toToolResult(data: unknown, text?: string): {
@@ -108,7 +127,5 @@ declare function resolveWorkspaceRoot(start?: string): string;
 declare function assertInsideRoot(root: string, targetPath: string): string;
 declare function resolveSubPath(root: string, relativePath: string): string;
 
-declare function startStdioServer(): Promise<void>;
-
-export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, toToolError, toToolResult };
-export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, SearchMatch };
+export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };
+export type { CommandResult, CreateServerOptions, ExposedPackageId, ExposedPackageSummary, McpServerHandle, SearchMatch, StartMcpServerOptions };

package/dist/index.mjs

@@ -1,12 +1,15 @@
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import fs$1 from 'node:fs/promises';
 import path from 'node:path';
-import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
 import fs from 'node:fs';
 import { spawn } from 'node:child_process';
+import { Buffer } from 'node:buffer';
+import http from 'node:http';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
 
 const MCP_SERVER_NAME = "@weapp-vite/mcp";
 const MCP_SERVER_VERSION = "2.0.0";
@@ -643,11 +646,158 @@ async function createWeappViteMcpServer(options) {
   };
 }
 
-async function startStdioServer() {
-  const { server } = await createWeappViteMcpServer();
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
+const DEFAULT_MCP_HOST = "127.0.0.1";
+const DEFAULT_MCP_PORT = 3088;
+const DEFAULT_MCP_ENDPOINT = "/mcp";
+function normalizeEndpoint(input) {
+  const value = typeof input === "string" ? input.trim() : "";
+  if (!value) {
+    return DEFAULT_MCP_ENDPOINT;
+  }
+  return value.startsWith("/") ? value : `/${value}`;
+}
+function normalizePort(input) {
+  if (typeof input === "number" && Number.isInteger(input) && input > 0 && input <= 65535) {
+    return input;
+  }
+  return DEFAULT_MCP_PORT;
+}
+async function parseJsonBody(req) {
+  if (req.method !== "POST") {
+    return void 0;
+  }
+  const chunks = [];
+  for await (const chunk of req) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  if (chunks.length === 0) {
+    return void 0;
+  }
+  const raw = Buffer.concat(chunks).toString("utf8").trim();
+  if (!raw) {
+    return void 0;
+  }
+  return JSON.parse(raw);
+}
+function writeJson(res, statusCode, payload) {
+  if (res.headersSent) {
+    return;
+  }
+  res.statusCode = statusCode;
+  res.setHeader("content-type", "application/json");
+  res.end(JSON.stringify(payload));
+}
+async function startStdioServer$1(options) {
+  const previousCwd = process.cwd();
+  if (options?.workspaceRoot) {
+    process.chdir(options.workspaceRoot);
+  }
+  try {
+    const { server } = await createWeappViteMcpServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+  } finally {
+    if (options?.workspaceRoot) {
+      process.chdir(previousCwd);
+    }
+  }
+}
+async function startStreamableHttpServer(options) {
+  const {
+    endpoint = DEFAULT_MCP_ENDPOINT,
+    host = DEFAULT_MCP_HOST,
+    port = DEFAULT_MCP_PORT,
+    workspaceRoot,
+    unref = false,
+    quiet = false,
+    onReady
+  } = options;
+  const normalizedEndpoint = normalizeEndpoint(endpoint);
+  const normalizedPort = normalizePort(port);
+  const { server: mcpServer } = await createWeappViteMcpServer({ workspaceRoot });
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: void 0
+  });
+  await mcpServer.connect(transport);
+  const httpServer = http.createServer(async (req, res) => {
+    try {
+      const hostHeader = req.headers.host ?? `${host}:${normalizedPort}`;
+      const url = new URL(req.url ?? "/", `http://${hostHeader}`);
+      if (url.pathname !== normalizedEndpoint) {
+        writeJson(res, 404, {
+          jsonrpc: "2.0",
+          error: {
+            code: -32004,
+            message: `Not Found: ${url.pathname}`
+          },
+          id: null
+        });
+        return;
+      }
+      const method = req.method ?? "GET";
+      if (!["GET", "POST", "DELETE"].includes(method)) {
+        writeJson(res, 405, {
+          jsonrpc: "2.0",
+          error: {
+            code: -32005,
+            message: `Method Not Allowed: ${method}`
+          },
+          id: null
+        });
+        return;
+      }
+      const body = await parseJsonBody(req);
+      await transport.handleRequest(req, res, body);
+    } catch (error) {
+      writeJson(res, 500, {
+        jsonrpc: "2.0",
+        error: {
+          code: -32603,
+          message: error instanceof Error ? error.message : String(error)
+        },
+        id: null
+      });
+    }
+  });
+  await new Promise((resolve, reject) => {
+    httpServer.once("error", reject);
+    httpServer.listen(normalizedPort, host, () => {
+      resolve();
+    });
+  });
+  if (unref) {
+    httpServer.unref();
+  }
+  if (!quiet) {
+    onReady?.(`[mcp] streamable-http ready at http://${host}:${normalizedPort}${normalizedEndpoint}`);
+  }
+  return {
+    transport: "streamable-http",
+    close: async () => {
+      await transport.close();
+      await new Promise((resolve, reject) => {
+        httpServer.close((error) => {
+          if (error) {
+            reject(error);
+            return;
+          }
+          resolve();
+        });
+      });
+    }
+  };
+}
+async function startWeappViteMcpServer(options) {
+  const transport = options?.transport ?? "stdio";
+  if (transport === "streamable-http") {
+    return startStreamableHttpServer(options ?? {});
+  }
+  await startStdioServer$1(options);
+  return {
+    transport: "stdio"
+  };
 }
+
 function isDirectExecution() {
   const entry = process.argv[1];
   if (!entry) {
@@ -665,4 +815,4 @@ ${message}
   });
 }
 
-export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, toToolError, toToolResult };
+export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, assertInsideRoot, createWeappViteMcpServer, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer$1 as startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/mcp",
   "type": "module",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "mcp",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "ISC",
@@ -40,6 +40,7 @@
     "build": "unbuild",
     "test": "vitest run",
     "test:dev": "vitest",
+    "typecheck": "tsc --noEmit",
     "release": "pnpm publish",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",