staff-mcp 1.0.0

package/dist/tools/shell-tools.js

@@ -0,0 +1,39 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import { z } from "zod";
+import { DEFAULT_TIMEOUT } from "../constants.js";
+const execAsync = promisify(exec);
+/**
+ * Registers shell-related tools using the latest registerTool API.
+ */
+export function registerShellTools(server, security) {
+    server.registerTool("execute_command", {
+        description: "Execute a shell command in a specified directory (sandboxed).",
+        inputSchema: z.object({
+            command: z.string().describe("The shell command to execute."),
+            cwd: z.string().optional().describe("Directory to execute command from (must be allowed). Defaults to the workspace root."),
+        }).strict(),
+    }, async ({ command, cwd }) => {
+        try {
+            const validatedCwd = security.validateDirectory(cwd || ".");
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: validatedCwd,
+                timeout: DEFAULT_TIMEOUT,
+            });
+            const output = [
+                stdout ? `STDOUT:\n${stdout}` : "",
+                stderr ? `STDERR:\n${stderr}` : "",
+            ].filter(Boolean).join("\n\n");
+            return {
+                content: [{ type: "text", text: output || "(No output from command)" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Command execution failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=shell-tools.js.map

package/dist/tools/shell-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-tools.js","sourceRoot":"","sources":["../../src/tools/shell-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,QAAyB;IAC7E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC7D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sFAAsF,CAAC;SAC5H,CAAC,CAAC,MAAM,EAAE;KACZ,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YAE5D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClD,GAAG,EAAE,YAAY;gBACjB,OAAO,EAAE,eAAe;aACzB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;gBAClC,MAAM,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;aACnC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,0BAA0B,EAAE,CAAC;aACxE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/transports/http.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Starts an Express server that hosts the MCP server over Streamable HTTP.
+ */
+export declare function startHttpServer(server: McpServer, port: number, host?: string): Promise<void>;

package/dist/transports/http.js

@@ -0,0 +1,58 @@
+import express from "express";
+import cors from "cors";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { randomUUID } from "node:crypto";
+/**
+ * Starts an Express server that hosts the MCP server over Streamable HTTP.
+ */
+export async function startHttpServer(server, port, host = "0.0.0.0") {
+    const app = express();
+    // Enable CORS for all origins, including the MCP Inspector
+    app.use(cors());
+    // Necessary for processing JSON-RPC messages (POST)
+    // We use express.json() but also need to be careful not to consume the stream if transport needs it.
+    // However, StreamableHTTPServerTransport.handleRequest accepts parsedBody.
+    app.use(express.json());
+    // Use a single transport instance for the lifetime of the HTTP server.
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        // VERY IMPORTANT: Enable JSON responses for POST requests. 
+        // This allows the client to receive tool lists and call results directly in the POST response,
+        // which is what the Anthropic Inspector and many other clients expect.
+        enableJsonResponse: true,
+    });
+    // Connect the MCP server instance to this transport.
+    await server.connect(transport);
+    /**
+     * Unified handler for MCP requests.
+     * Handles GET (SSE) and POST (JSON-RPC).
+     */
+    const mcpHandler = async (req, res) => {
+        try {
+            // In Streamable HTTP, handleRequest handles the full lifecycle based on method.
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error("[MCP HTTP Error]:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: "Internal Server Error",
+                    message: error instanceof Error ? error.message : String(error)
+                });
+            }
+        }
+    };
+    // Route for all MCP interactions.
+    app.all("/mcp", mcpHandler);
+    // Standard fallbacks
+    app.get("/sse", mcpHandler);
+    app.post("/messages", mcpHandler);
+    return new Promise((resolve) => {
+        app.listen(port, host, () => {
+            console.error(`[MCP HTTP] Server listening on http://${host}:${port}/mcp`);
+            console.error(`[MCP HTTP] JSON Response enabled: true`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/transports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAiB,EAAE,IAAY,EAAE,OAAe,SAAS;IAC7F,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,2DAA2D;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhB,oDAAoD;IACpD,qGAAqG;IACrG,2EAA2E;IAC3E,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,uEAAuE;IACvE,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;QACtC,4DAA4D;QAC5D,+FAA+F;QAC/F,uEAAuE;QACvE,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC;;;OAGG;IACH,MAAM,UAAU,GAAG,KAAK,EAAE,GAAoB,EAAE,GAAqB,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,gFAAgF;YAChF,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,KAAK,EAAE,uBAAuB;oBAC9B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,kCAAkC;IAClC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE5B,qBAAqB;IACrB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAElC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,yCAAyC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;YAC3E,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACxD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/transports/stdio.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function startStdioServer(server: McpServer): Promise<void>;

package/dist/transports/stdio.js

@@ -0,0 +1,18 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+export async function startStdioServer(server) {
+    const transport = new StdioServerTransport();
+    // Redirect stdout to stderr so console.log doesn't break protocol
+    const originalLog = console.log;
+    console.log = (...args) => {
+        console.error(...args);
+    };
+    try {
+        await server.connect(transport);
+        console.error("MCP Server (Stdio) is running.");
+    }
+    catch (error) {
+        console.error("Stdio connection failed:", error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAiB;IACtD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,kEAAkE;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAChC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "staff-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "bin": {
+    "staff-mcp": "./dist/src/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_zh.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/src/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "node --test dist/tests/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.1.0",
+    "commander": "^12.1.0",
+    "cors": "^2.8.5",
+    "express": "^4.21.1",
+    "ts-morph": "^24.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.9.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  }
+}