Add MCP TypeScript server and client starter

.env.example

@@ -0,0 +1,13 @@
+# MCP server settings
+API_BASE_URL=https://api.example.com/
+API_KEY=your_api_key_here
+
+# MCP client settings
+MCP_SERVER_COMMAND=tsx
+MCP_SERVER_ARGS=src/server.ts
+
+# Optional API request run from client
+RUN_API_REQUEST=false
+API_REQUEST_PATH=/
+API_REQUEST_METHOD=GET
+API_REQUEST_BODY=

README.md

@@ -1 +1,57 @@
-# note
+# note
+
+## MCP TypeScript (Node.js) Starter
+
+This project provides a minimal MCP server and client written in TypeScript.
+The server exposes a simple `ping` tool plus an `api_request` tool that forwards
+requests to an external API using an API key you provide.
+
+### Prerequisites
+
+- Node.js 18+
+- npm
+
+### Setup
+
+```bash
+npm install
+cp .env.example .env
+```
+
+Update `.env` with your API settings:
+
+- `API_BASE_URL` - Base URL of the API you want to call.
+- `API_KEY` - API key provided by you.
+
+### Run the MCP server
+
+```bash
+npm run start:server
+```
+
+### Run the MCP client
+
+```bash
+npm run start:client
+```
+
+The client will:
+
+1. Start the MCP server via stdio.
+2. List available tools.
+3. Call the `ping` tool.
+
+If you want the client to also call the `api_request` tool, set:
+
+```bash
+RUN_API_REQUEST=true
+API_REQUEST_PATH=/v1/whatever
+API_REQUEST_METHOD=GET
+API_REQUEST_BODY=
+```
+
+### Build
+
+```bash
+npm run build
+```

package.json

@@ -0,0 +1,21 @@
+{
+  "name": "mcp-ts-node",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start:server": "tsx src/server.ts",
+    "start:client": "tsx src/client.ts",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.3",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  }
+}

src/client.ts

@@ -0,0 +1,47 @@
+import "dotenv/config";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+const serverCommand = process.env.MCP_SERVER_COMMAND ?? "tsx";
+const serverArgs =
+  process.env.MCP_SERVER_ARGS?.split(" ") ?? ["src/server.ts"];
+
+const transport = new StdioClientTransport({
+  command: serverCommand,
+  args: serverArgs,
+});
+
+const client = new Client(
+  {
+    name: "mcp-ts-node-client",
+    version: "0.1.0",
+  },
+  {
+    capabilities: {},
+  }
+);
+
+await client.connect(transport);
+
+const tools = await client.listTools();
+console.log("Available tools:", tools.tools.map((tool) => tool.name));
+
+const pingResult = await client.callTool({
+  name: "ping",
+  arguments: {},
+});
+console.log("Ping response:", pingResult.content);
+
+if (process.env.RUN_API_REQUEST === "true") {
+  const apiResult = await client.callTool({
+    name: "api_request",
+    arguments: {
+      path: process.env.API_REQUEST_PATH ?? "/",
+      method: process.env.API_REQUEST_METHOD ?? "GET",
+      body: process.env.API_REQUEST_BODY,
+    },
+  });
+  console.log("API response:", apiResult.content);
+}
+
+await client.close();

src/server.ts

@@ -0,0 +1,64 @@
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const apiBaseUrl = process.env.API_BASE_URL;
+const apiKey = process.env.API_KEY;
+
+const server = new McpServer({
+  name: "mcp-ts-node-server",
+  version: "0.1.0",
+});
+
+server.tool("ping", {}, async () => {
+  return {
+    content: [{ type: "text", text: "pong" }],
+  };
+});
+
+server.tool(
+  "api_request",
+  {
+    path: z.string().describe("Relative path to call, e.g. /v1/models"),
+    method: z.enum(["GET", "POST"]).default("GET"),
+    body: z.string().optional().describe("Raw JSON string for POST requests"),
+  },
+  async ({ path, method, body }) => {
+    if (!apiBaseUrl || !apiKey) {
+      return {
+        content: [
+          {
+            type: "text",
+            text:
+              "Missing API_BASE_URL or API_KEY. Set them in your environment or .env file.",
+          },
+        ],
+      };
+    }
+
+    const url = new URL(path, apiBaseUrl).toString();
+    const response = await fetch(url, {
+      method,
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+      },
+      body: method === "POST" ? body ?? "" : undefined,
+    });
+
+    const responseText = await response.text();
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: `status: ${response.status}\n${responseText}`,
+        },
+      ],
+    };
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}