fastmcp 1.0.0 → 1.0.2

package/dist/FastMCP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/FastMCP.ts"],"sourcesContent":["import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { SSEServerTransport } from \"@modelcontextprotocol/sdk/server/sse.js\";\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  McpError,\n  ReadResourceRequestSchema,\n  ServerCapabilities,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type { z } from \"zod\";\nimport http from \"http\";\n\ntype ToolParameters = z.ZodTypeAny;\n\ntype Tool<Params extends ToolParameters = ToolParameters> = {\n  name: string;\n  description?: string;\n  parameters?: Params;\n  execute: (args: z.infer<Params>) => Promise<unknown>;\n};\n\ntype Resource = {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n  load: () => Promise<{ text: string } | { blob: string }>;\n};\n\ntype PromptArgument = Readonly<{\n  name: string;\n  description?: string;\n  required?: boolean;\n}>;\n\ntype ArgumentsToObject<T extends PromptArgument[]> = {\n  [K in T[number][\"name\"]]: Extract<\n    T[number],\n    { name: K }\n  >[\"required\"] extends true\n    ? string\n    : string | undefined;\n};\n\ntype Prompt<\n  Arguments extends PromptArgument[] = PromptArgument[],\n  Args = ArgumentsToObject<Arguments>,\n> = {\n  name: string;\n  description?: string;\n  arguments?: Arguments;\n  load: (args: Args) => Promise<string>;\n};\n\ntype ServerOptions = {\n  name: string;\n  version: `${number}.${number}.${number}`;\n};\n\nexport class FastMCP {\n  #tools: Tool[];\n  #resources: Resource[];\n  #prompts: Prompt[];\n  #server: Server | null = null;\n  #options: ServerOptions;\n\n  constructor(public options: ServerOptions) {\n    this.#options = options;\n    this.#tools = [];\n    this.#resources = [];\n    this.#prompts = [];\n  }\n\n  private setupHandlers(server: Server) {\n    this.setupErrorHandling(server);\n\n    if (this.#tools.length) {\n      this.setupToolHandlers(server);\n    }\n\n    if (this.#resources.length) {\n      this.setupResourceHandlers(server);\n    }\n\n    if (this.#prompts.length) {\n      this.setupPromptHandlers(server);\n    }\n  }\n\n  private setupErrorHandling(server: Server) {\n    server.onerror = (error) => {\n      console.error(\"[MCP Error]\", error);\n    };\n    process.on(\"SIGINT\", async () => {\n      await server.close();\n      process.exit(0);\n    });\n  }\n\n  private setupToolHandlers(server: Server) {\n    server.setRequestHandler(ListToolsRequestSchema, async () => {\n      return {\n        tools: this.#tools.map((tool) => {\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.parameters\n              ? zodToJsonSchema(tool.parameters)\n              : undefined,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(CallToolRequestSchema, async (request) => {\n      const tool = this.#tools.find(\n        (tool) => tool.name === request.params.name,\n      );\n\n      if (!tool) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown tool: ${request.params.name}`,\n        );\n      }\n\n      let args: any = undefined;\n\n      if (tool.parameters) {\n        const parsed = tool.parameters.safeParse(request.params.arguments);\n\n        if (!parsed.success) {\n          throw new McpError(\n            ErrorCode.InvalidRequest,\n            `Invalid ${request.params.name} arguments`,\n          );\n        }\n\n        args = parsed.data;\n      }\n\n      let result: any;\n\n      try {\n        result = await tool.execute(args);\n      } catch (error) {\n        return {\n          content: [{ type: \"text\", text: `Error: ${error}` }],\n          isError: true,\n        };\n      }\n\n      if (typeof result === \"string\") {\n        return {\n          content: [{ type: \"text\", text: result }],\n        };\n      }\n\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n      };\n    });\n  }\n\n  private setupResourceHandlers(server: Server) {\n    server.setRequestHandler(ListResourcesRequestSchema, async () => {\n      return {\n        resources: this.#resources.map((resource) => {\n          return {\n            uri: resource.uri,\n            name: resource.name,\n            mimeType: resource.mimeType,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\n      const resource = this.#resources.find(\n        (resource) => resource.uri === request.params.uri,\n      );\n\n      if (!resource) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown resource: ${request.params.uri}`,\n        );\n      }\n\n      let result: Awaited<ReturnType<Resource[\"load\"]>>;\n\n      try {\n        result = await resource.load();\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error reading resource: ${error}`,\n          {\n            uri: resource.uri,\n          },\n        );\n      }\n\n      return {\n        contents: [\n          {\n            uri: resource.uri,\n            mimeType: resource.mimeType,\n            ...result,\n          },\n        ],\n      };\n    });\n  }\n\n  private setupPromptHandlers(server: Server) {\n    server.setRequestHandler(ListPromptsRequestSchema, async () => {\n      return {\n        prompts: this.#prompts.map((prompt) => {\n          return {\n            name: prompt.name,\n            description: prompt.description,\n            arguments: prompt.arguments,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(GetPromptRequestSchema, async (request) => {\n      const prompt = this.#prompts.find(\n        (prompt) => prompt.name === request.params.name,\n      );\n\n      if (!prompt) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown prompt: ${request.params.name}`,\n        );\n      }\n\n      const args = request.params.arguments;\n\n      if (prompt.arguments) {\n        for (const arg of prompt.arguments) {\n          if (arg.required && !(args && arg.name in args)) {\n            throw new McpError(\n              ErrorCode.InvalidRequest,\n              `Missing required argument: ${arg.name}`,\n            );\n          }\n        }\n      }\n\n      let result: Awaited<ReturnType<Prompt[\"load\"]>>;\n\n      try {\n        result = await prompt.load(args as Record<string, string | undefined>);\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error loading prompt: ${error}`,\n        );\n      }\n\n      return {\n        description: prompt.description,\n        messages: [\n          {\n            role: \"user\",\n            content: { type: \"text\", text: result },\n          },\n        ],\n      };\n    });\n  }\n\n  public addTool<Params extends ToolParameters>(tool: Tool<Params>) {\n    this.#tools.push(tool as unknown as Tool);\n  }\n\n  public addResource(resource: Resource) {\n    this.#resources.push(resource);\n  }\n\n  public addPrompt<const Args extends PromptArgument[]>(prompt: Prompt<Args>) {\n    this.#prompts.push(prompt);\n  }\n\n  #httpServer: http.Server | null = null;\n\n  public async start(\n    options:\n      | { transportType: \"stdio\" }\n      | {\n          transportType: \"sse\";\n          sse: { endpoint: `/${string}`; port: number };\n        } = {\n      transportType: \"stdio\",\n    },\n  ) {\n    const capabilities: ServerCapabilities = {};\n\n    if (this.#tools.length) {\n      capabilities.tools = {};\n    }\n\n    if (this.#resources.length) {\n      capabilities.resources = {};\n    }\n\n    if (this.#prompts.length) {\n      capabilities.prompts = {};\n    }\n\n    this.#server = new Server(\n      { name: this.#options.name, version: this.#options.version },\n      { capabilities },\n    );\n\n    this.setupHandlers(this.#server);\n\n    if (options.transportType === \"stdio\") {\n      const transport = new StdioServerTransport();\n\n      await this.#server.connect(transport);\n\n      console.error(`server is running on stdio`);\n    } else if (options.transportType === \"sse\") {\n      let activeTransport: SSEServerTransport | null = null;\n\n      /**\n       * Adopted from https://dev.classmethod.jp/articles/mcp-sse/\n       */\n      this.#httpServer = http.createServer(async (req, res) => {\n        if (req.method === \"GET\" && req.url === options.sse.endpoint) {\n          const transport = new SSEServerTransport(\"/messages\", res);\n\n          activeTransport = transport;\n\n          if (!this.#server) {\n            throw new Error(\"Server not initialized\");\n          }\n\n          await this.#server.connect(transport);\n\n          res.on(\"close\", () => {\n            console.log(\"SSE connection closed\");\n            if (activeTransport === transport) {\n              activeTransport = null;\n            }\n          });\n\n          this.startSending(transport);\n          return;\n        }\n\n        if (req.method === \"POST\" && req.url?.startsWith(\"/messages\")) {\n          if (!activeTransport) {\n            res.writeHead(400).end(\"No active transport\");\n            return;\n          }\n          await activeTransport.handlePostMessage(req, res);\n          return;\n        }\n\n        res.writeHead(404).end();\n      });\n\n      this.#httpServer.listen(options.sse.port, \"0.0.0.0\");\n\n      console.error(\n        `server is running on SSE at http://localhost:${options.sse.port}${options.sse.endpoint}`,\n      );\n    } else {\n      throw new Error(\"Invalid transport type\");\n    }\n  }\n\n  /**\n   * @see https://dev.classmethod.jp/articles/mcp-sse/\n   */\n  private async startSending(transport: SSEServerTransport) {\n    try {\n      await transport.send({\n        jsonrpc: \"2.0\",\n        method: \"sse/connection\",\n        params: { message: \"SSE Connection established\" },\n      });\n\n      let messageCount = 0;\n      const interval = setInterval(async () => {\n        messageCount++;\n\n        const message = `Message ${messageCount} at ${new Date().toISOString()}`;\n\n        try {\n          await transport.send({\n            jsonrpc: \"2.0\",\n            method: \"sse/message\",\n            params: { data: message },\n          });\n\n          console.log(`Sent: ${message}`);\n\n          if (messageCount === 10) {\n            clearInterval(interval);\n\n            await transport.send({\n              jsonrpc: \"2.0\",\n              method: \"sse/complete\",\n              params: { message: \"Stream completed\" },\n            });\n            console.log(\"Stream completed\");\n          }\n        } catch (error) {\n          console.error(\"Error sending message:\", error);\n          clearInterval(interval);\n        }\n      }, 1000);\n    } catch (error) {\n      console.error(\"Error in startSending:\", error);\n    }\n  }\n\n  public async stop() {\n    if (this.#httpServer) {\n      this.#httpServer.close();\n    }\n  }\n}\n"],"mappings":"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","names":["tool","resource","prompt"]}

package/dist/bin/fastmcp.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/fastmcp.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+// src/bin/fastmcp.ts
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { $ } from "execa";
+await yargs(hideBin(process.argv)).scriptName("fastmcp").command(
+  "dev <file>",
+  "Start a development server",
+  (yargs2) => {
+    return yargs2.positional("file", {
+      type: "string",
+      describe: "The path to the server file",
+      demandOption: true
+    });
+  },
+  async (argv) => {
+    const command = argv.file.endsWith(".ts") ? ["npx", "tsx", argv.file] : ["node", argv.file];
+    await $({
+      stdin: "inherit",
+      stdout: "inherit",
+      stderr: "inherit"
+    })`npx @wong2/mcp-cli ${command}`;
+  }
+).command(
+  "inspect <file>",
+  "Inspect a server file",
+  (yargs2) => {
+    return yargs2.positional("file", {
+      type: "string",
+      describe: "The path to the server file",
+      demandOption: true
+    });
+  },
+  async (argv) => {
+    await $({
+      stdout: "inherit",
+      stderr: "inherit"
+    })`npx @modelcontextprotocol/inspector node ${argv.file}`;
+  }
+).help().parseAsync();
+//# sourceMappingURL=fastmcp.js.map

package/dist/bin/fastmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bin/fastmcp.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport { $ } from \"execa\";\n\nawait yargs(hideBin(process.argv))\n  .scriptName(\"fastmcp\")\n  .command(\n    \"dev <file>\",\n    \"Start a development server\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        type: \"string\",\n        describe: \"The path to the server file\",\n        demandOption: true,\n      });\n    },\n    async (argv) => {\n      const command = argv.file.endsWith(\".ts\")\n        ? [\"npx\", \"tsx\", argv.file]\n        : [\"node\", argv.file];\n\n      await $({\n        stdin: \"inherit\",\n        stdout: \"inherit\",\n        stderr: \"inherit\",\n      })`npx @wong2/mcp-cli ${command}`;\n    },\n  )\n  .command(\n    \"inspect <file>\",\n    \"Inspect a server file\",\n    (yargs) => {\n      return yargs.positional(\"file\", {\n        type: \"string\",\n        describe: \"The path to the server file\",\n        demandOption: true,\n      });\n    },\n    async (argv) => {\n      await $({\n        stdout: \"inherit\",\n        stderr: \"inherit\",\n      })`npx @modelcontextprotocol/inspector node ${argv.file}`;\n    },\n  )\n  .help()\n  .parseAsync();\n"],"mappings":";;;AAEA,OAAO,WAAW;AAClB,SAAS,eAAe;AACxB,SAAS,SAAS;AAElB,MAAM,MAAM,QAAQ,QAAQ,IAAI,CAAC,EAC9B,WAAW,SAAS,EACpB;AAAA,EACC;AAAA,EACA;AAAA,EACA,CAACA,WAAU;AACT,WAAOA,OAAM,WAAW,QAAQ;AAAA,MAC9B,MAAM;AAAA,MACN,UAAU;AAAA,MACV,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAAA,EACA,OAAO,SAAS;AACd,UAAM,UAAU,KAAK,KAAK,SAAS,KAAK,IACpC,CAAC,OAAO,OAAO,KAAK,IAAI,IACxB,CAAC,QAAQ,KAAK,IAAI;AAEtB,UAAM,EAAE;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV,CAAC,uBAAuB,OAAO;AAAA,EACjC;AACF,EACC;AAAA,EACC;AAAA,EACA;AAAA,EACA,CAACA,WAAU;AACT,WAAOA,OAAM,WAAW,QAAQ;AAAA,MAC9B,MAAM;AAAA,MACN,UAAU;AAAA,MACV,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAAA,EACA,OAAO,SAAS;AACd,UAAM,EAAE;AAAA,MACN,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV,CAAC,6CAA6C,KAAK,IAAI;AAAA,EACzD;AACF,EACC,KAAK,EACL,WAAW;","names":["yargs"]}

package/eslint.config.js

@@ -0,0 +1,3 @@
+import perfectionist from "eslint-plugin-perfectionist";
+
+export default [perfectionist.configs["recommended-alphabetical"]];

package/package.json

@@ -1,11 +1,64 @@
 {
   "name": "fastmcp",
-  "version": "1.0.0",
-  "main": "index.js",
+  "version": "1.0.2",
+  "main": "dist/fastmcp.js",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsup",
+    "test": "vitest run",
+    "format": "prettier --write . && eslint --fix ."
   },
-  "author": "",
-  "license": "ISC",
-  "description": ""
+  "bin": {
+    "fastmcp": "dist/bin/fastmcp.js"
+  },
+  "keywords": [
+    "MCP",
+    "SSE"
+  ],
+  "type": "module",
+  "author": "Frank Fiegel <frank@glama.ai>",
+  "license": "MIT",
+  "description": "A TypeScript framework for building MCP servers.",
+  "module": "dist/fastmcp.js",
+  "types": "dist/fastmcp.d.ts",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "execa": "^9.5.2",
+    "yargs": "^17.7.2",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.1"
+  },
+  "repository": {
+    "url": "https://github.com/punkpeye/fastmcp"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ]
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.0",
+    "@types/node": "^22.10.2",
+    "@types/yargs": "^17.0.33",
+    "eslint": "^9.17.0",
+    "eslint-plugin-perfectionist": "^4.4.0",
+    "eventsource": "^3.0.2",
+    "get-port-please": "^3.1.2",
+    "prettier": "^3.4.2",
+    "semantic-release": "^24.2.0",
+    "tsup": "^8.3.5",
+    "vitest": "^2.1.8"
+  },
+  "tsup": {
+    "entry": [
+      "src/FastMCP.ts",
+      "src/bin/fastmcp.ts"
+    ],
+    "format": [
+      "esm"
+    ],
+    "dts": true,
+    "splitting": true,
+    "sourcemap": true,
+    "clean": true
+  }
 }

package/src/FastMCP.test.ts

@@ -0,0 +1,179 @@
+import { FastMCP } from "./FastMCP.js";
+import { z } from "zod";
+import { test, expect } from "vitest";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { getRandomPort } from "get-port-please";
+import { EventSource } from "eventsource";
+
+// @ts-expect-error - figure out how to use --experimental-eventsource with vitest
+global.EventSource = EventSource;
+
+const runWithTestServer = async ({
+  run,
+  start,
+}: {
+  start: () => Promise<FastMCP>;
+  run: ({ client }: { client: Client }) => Promise<void>;
+}) => {
+  const port = await getRandomPort();
+
+  const server = await start();
+
+  await server.start({
+    transportType: "sse",
+    sse: {
+      endpoint: "/sse",
+      port,
+    },
+  });
+
+  try {
+    const client = new Client(
+      {
+        name: "example-client",
+        version: "1.0.0",
+      },
+      {
+        capabilities: {},
+      },
+    );
+
+    const transport = new SSEClientTransport(
+      new URL(`http://localhost:${port}/sse`),
+    );
+
+    await client.connect(transport);
+
+    await run({ client });
+  } finally {
+    await server.stop();
+  }
+
+  return port;
+};
+
+test("adds tools", async () => {
+  await runWithTestServer({
+    start: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addTool({
+        name: "add",
+        description: "Add two numbers",
+        parameters: z.object({
+          a: z.number(),
+          b: z.number(),
+        }),
+        execute: async (args) => {
+          return args.a + args.b;
+        },
+      });
+
+      return server;
+    },
+    run: async ({ client }) => {
+      expect(await client.listTools()).toEqual({
+        tools: [
+          {
+            name: "add",
+            description: "Add two numbers",
+            inputSchema: {
+              additionalProperties: false,
+              $schema: "http://json-schema.org/draft-07/schema#",
+              type: "object",
+              properties: {
+                a: { type: "number" },
+                b: { type: "number" },
+              },
+              required: ["a", "b"],
+            },
+          },
+        ],
+      });
+    },
+  });
+});
+
+test("adds resources", async () => {
+  await runWithTestServer({
+    start: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addResource({
+        uri: "file:///logs/app.log",
+        name: "Application Logs",
+        mimeType: "text/plain",
+        async load() {
+          return {
+            text: "Example log content",
+          };
+        },
+      });
+
+      return server;
+    },
+    run: async ({ client }) => {
+      expect(await client.listResources()).toEqual({
+        resources: [
+          {
+            uri: "file:///logs/app.log",
+            name: "Application Logs",
+            mimeType: "text/plain",
+          },
+        ],
+      });
+    },
+  });
+});
+
+test("adds prompts", async () => {
+  await runWithTestServer({
+    start: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addPrompt({
+        name: "git-commit",
+        description: "Generate a Git commit message",
+        arguments: [
+          {
+            name: "changes",
+            description: "Git diff or description of changes",
+            required: true,
+          },
+        ],
+        load: async (args) => {
+          return `Generate a concise but descriptive commit message for these changes:\n\n${args.changes}`;
+        },
+      });
+
+      return server;
+    },
+    run: async ({ client }) => {
+      expect(await client.listPrompts()).toEqual({
+        prompts: [
+          {
+            name: "git-commit",
+            description: "Generate a Git commit message",
+            arguments: [
+              {
+                name: "changes",
+                description: "Git diff or description of changes",
+                required: true,
+              },
+            ],
+          },
+        ],
+      });
+    },
+  });
+});