mcp-ts-transcript 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# mcp-ts-transcript
+
+MCP server with a single tool that compiles TypeScript code to JavaScript using the TypeScript compiler API.
+
+## Installation
+
+```bash
+npx mcp-ts-transcript
+```
+
+## Usage with Claude Code
+
+```bash
+claude mcp add -s user ts-transcript npx mcp-ts-transcript
+```
+
+## Tool
+
+### `compile_typescript`
+
+Receives TypeScript source code and returns the compiled JavaScript.
+
+**Input**
+
+| Parameter | Type   | Required | Description               |
+|-----------|--------|----------|---------------------------|
+| `code`    | string | yes      | TypeScript code to compile |
+
+**Output**
+
+Returns the compiled JavaScript as plain text. If the compilation fails, returns the error message with `isError: true`.
+
+**Example**
+
+Input:
+```typescript
+const greet = (name: string): string => `Hello, ${name}!`;
+console.log(greet("World"));
+```
+
+Output:
+```javascript
+const greet = (name) => `Hello, ${name}!`;
+console.log(greet("World"));
+```
+
+## Compiler options
+
+Compiled with the following fixed options:
+
+- `target`: ES2020
+- `module`: CommonJS
+- `esModuleInterop`: true
+- `strict`: false
+
+## Development
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as ts from "typescript";
+const server = new Server({ name: "ts-transcript", version: "1.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "compile_typescript",
+            description: "Receives TypeScript code, compiles it and returns the JavaScript output.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    code: {
+                        type: "string",
+                        description: "TypeScript source code to compile",
+                    },
+                },
+                required: ["code"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name !== "compile_typescript") {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+    const { code } = request.params.arguments;
+    const result = ts.transpileModule(code, {
+        compilerOptions: {
+            target: ts.ScriptTarget.ES2020,
+            module: ts.ModuleKind.CommonJS,
+            esModuleInterop: true,
+            strict: false,
+        },
+        reportDiagnostics: true,
+    });
+    if (result.diagnostics && result.diagnostics.length > 0) {
+        const errors = result.diagnostics
+            .map((d) => ts.flattenDiagnosticMessageText(d.messageText, "\n"))
+            .join("\n");
+        return {
+            content: [{ type: "text", text: `Compilation errors:\n${errors}` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: result.outputText }],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("ts-transcript MCP running on stdio");

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "mcp-ts-transcript",
+  "version": "1.0.0",
+  "description": "MCP server that compiles TypeScript code to JavaScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-ts-transcript": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "keywords": ["mcp", "typescript", "compiler"],
+  "author": "Confience",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}