feat: implementing FastMCP standard for templates

Author: vcart

bin/create-mcp-server.js

@@ -3,7 +3,6 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
 
 // Get the directory where the source files are stored
 const __filename = fileURLToPath(import.meta.url);
@@ -171,7 +170,7 @@ function createProjectPackageJson() {
       "typescript": "^5.8.2"
     },
     dependencies: {
-      "@modelcontextprotocol/sdk": "^1.7.0",
+      "fastmcp": "^1.21.0",
       "cors": "^2.8.5",
       "express": "^4.21.2",
       "zod": "^3.24.2"

package.json

@@ -69,9 +69,9 @@
     "typescript": "^5.8.2"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.7.0",
     "cors": "^2.8.5",
     "express": "^4.21.2",
+    "fastmcp": "^1.21.0",
     "zod": "^3.24.2"
   },
   "engines": {

src/core/prompts.ts

@@ -1,26 +1,24 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FastMCP } from "fastmcp";
 import { z } from "zod";
 
 /**
  * Register all prompts with the MCP server
- * @param server The MCP server instance
+ * @param server The FastMCP server instance
  */
-export function registerPrompts(server: McpServer) {
+export function registerPrompts(server: FastMCP) {
   // Example prompt
-  server.prompt(
-    "greeting",
-    "A simple greeting prompt",
-    {
-      name: z.string().describe("Name to greet")
-    },
-    (params: { name: string }) => ({
-      messages: [{
-        role: "user",
-        content: {
-          type: "text",
-          text: `Hello, ${params.name}! How can I help you today?`
-        }
-      }]
-    })
-  );
+  server.addPrompt({
+    name: "greeting",
+    description: "A simple greeting prompt",
+    arguments: [
+      {
+        name: "name",
+        description: "Name to greet",
+        required: true,
+      },
+    ],
+    load: async ({ name }) => {
+      return `Hello, ${name}! How can I help you today?`;
+    }
+  });
 }

src/core/resources.ts

@@ -1,23 +1,27 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FastMCP } from "fastmcp";
 import * as services from "./services/index.js";
 
 /**
  * Register all resources with the MCP server
- * @param server The MCP server instance
+ * @param server The FastMCP server instance
  */
-export function registerResources(server: McpServer) {
+export function registerResources(server: FastMCP) {
   // Example resource
-  server.resource(
-    "example_resource", 
-    "example://{id}",
-    async (uri: URL) => {
-      const id = uri.pathname.split('/').pop();
+  server.addResourceTemplate({
+    uriTemplate: "example://{id}",
+    name: "Example Resource",
+    mimeType: "text/plain",
+    arguments: [
+      {
+        name: "id",
+        description: "Resource ID",
+        required: true,
+      },
+    ],
+    async load({ id }) {
       return {
-        contents: [{
-          uri: uri.toString(),
-          text: `This is an example resource with ID: ${id}`
-        }]
+        text: `This is an example resource with ID: ${id}`
       };
     }
-  );
+  });
 } 

src/core/tools.ts

@@ -1,50 +1,36 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { FastMCP } from "fastmcp";
 import { z } from "zod";
 import * as services from "./services/index.js";
 
 /**
  * Register all tools with the MCP server
  * 
- * @param server The MCP server instance
+ * @param server The FastMCP server instance
  */
-export function registerTools(server: McpServer) {
+export function registerTools(server: FastMCP) {
   // Greeting tool
-  server.tool(
-    "hello_world",
-    "A simple hello world tool",
-    {
+  server.addTool({
+    name: "hello_world",
+    description: "A simple hello world tool",
+    parameters: z.object({
       name: z.string().describe("Name to greet")
-    },
-    async (params: { name: string }) => {
+    }),
+    execute: async (params) => {
       const greeting = services.GreetingService.generateGreeting(params.name);
-      return {
-        content: [
-          {
-            type: "text",
-            text: greeting
-          }
-        ]
-      };
+      return greeting;
     }
-  );
+  });
 
   // Farewell tool
-  server.tool(
-    "goodbye",
-    "A simple goodbye tool",
-    {
+  server.addTool({
+    name: "goodbye",
+    description: "A simple goodbye tool",
+    parameters: z.object({
       name: z.string().describe("Name to bid farewell to")
-    },
-    async (params: { name: string }) => {
+    }),
+    execute: async (params) => {
       const farewell = services.GreetingService.generateFarewell(params.name);
-      return {
-        content: [
-          {
-            type: "text",
-            text: farewell
-          }
-        ]
-      };
+      return farewell;
     }
-  );
+  });
 }

src/index.ts

@@ -1,12 +1,15 @@
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { FastMCP } from "fastmcp";
 import startServer from "./server/server.js";
 
 // Start the server
 async function main() {
   try {
     const server = await startServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    
+    server.start({
+      transportType: "stdio",
+    });
+    
     console.error("MCP Server running on stdio");
   } catch (error) {
     console.error("Error starting MCP server:", error);