fastmcp 1.22.4 → 1.23.1

package/src/bin/fastmcp.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
+import { execa } from "execa";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import { execa } from "execa";
 
 await yargs(hideBin(process.argv))
   .scriptName("fastmcp")
@@ -11,17 +11,17 @@ await yargs(hideBin(process.argv))
     "Start a development server",
     (yargs) => {
       return yargs.positional("file", {
-        type: "string",
-        describe: "The path to the server file",
         demandOption: true,
+        describe: "The path to the server file",
+        type: "string",
       });
     },
     async (argv) => {
       try {
         await execa({
+          stderr: "inherit",
           stdin: "inherit",
           stdout: "inherit",
-          stderr: "inherit",
         })`npx @wong2/mcp-cli npx tsx ${argv.file}`;
       } catch {
         process.exit(1);
@@ -33,16 +33,16 @@ await yargs(hideBin(process.argv))
     "Inspect a server file",
     (yargs) => {
       return yargs.positional("file", {
-        type: "string",
-        describe: "The path to the server file",
         demandOption: true,
+        describe: "The path to the server file",
+        type: "string",
       });
     },
     async (argv) => {
       try {
         await execa({
-          stdout: "inherit",
           stderr: "inherit",
+          stdout: "inherit",
         })`npx @modelcontextprotocol/inspector npx tsx ${argv.file}`;
       } catch {
         process.exit(1);

package/src/examples/addition.ts

@@ -1,10 +1,11 @@
+import { type } from "arktype";
+import * as v from "valibot";
+import { z } from "zod";
+
 /**
  * This is a complete example of an MCP server.
  */
 import { FastMCP } from "../FastMCP.js";
-import { z } from "zod";
-import { type } from "arktype";
-import * as v from "valibot";
 
 const server = new FastMCP({
   name: "Addition",
@@ -18,14 +19,19 @@ const AddParamsZod = z.object({
 });
 
 server.addTool({
-  name: "add-zod",
+  annotations: {
+    openWorldHint: false, // This tool doesn't interact with external systems
+    readOnlyHint: true, // This tool doesn't modify anything
+    title: "Addition (Zod)",
+  },
   description: "Add two numbers (using Zod schema)",
-  parameters: AddParamsZod,
   execute: async (args) => {
     // args is typed as { a: number, b: number }
     console.log(`[Zod] Adding ${args.a} and ${args.b}`);
     return String(args.a + args.b);
   },
+  name: "add-zod",
+  parameters: AddParamsZod,
 });
 
 // --- ArkType Example ---
@@ -35,14 +41,21 @@ const AddParamsArkType = type({
 });
 
 server.addTool({
-  name: "add-arktype",
+  annotations: {
+    destructiveHint: true, // This would perform destructive operations
+    idempotentHint: true, // But operations can be repeated safely
+    openWorldHint: true, // Interacts with external systems
+    readOnlyHint: false, // Example showing a modifying tool
+    title: "Addition (ArkType)",
+  },
   description: "Add two numbers (using ArkType schema)",
-  parameters: AddParamsArkType,
   execute: async (args) => {
     // args is typed as { a: number, b: number } based on AddParamsArkType.infer
     console.log(`[ArkType] Adding ${args.a} and ${args.b}`);
     return String(args.a + args.b);
   },
+  name: "add-arktype",
+  parameters: AddParamsArkType,
 });
 
 // --- Valibot Example ---
@@ -52,39 +65,44 @@ const AddParamsValibot = v.object({
 });
 
 server.addTool({
-  name: "add-valibot",
+  annotations: {
+    openWorldHint: false,
+    readOnlyHint: true,
+    title: "Addition (Valibot)",
+  },
   description: "Add two numbers (using Valibot schema)",
-  parameters: AddParamsValibot,
   execute: async (args) => {
     console.log(`[Valibot] Adding ${args.a} and ${args.b}`);
     return String(args.a + args.b);
   },
+  name: "add-valibot",
+  parameters: AddParamsValibot,
 });
 
 server.addResource({
-  uri: "file:///logs/app.log",
-  name: "Application Logs",
-  mimeType: "text/plain",
   async load() {
     return {
       text: "Example log content",
     };
   },
+  mimeType: "text/plain",
+  name: "Application Logs",
+  uri: "file:///logs/app.log",
 });
 
 server.addPrompt({
-  name: "git-commit",
-  description: "Generate a Git commit message",
   arguments: [
     {
-      name: "changes",
       description: "Git diff or description of changes",
+      name: "changes",
       required: true,
     },
   ],
+  description: "Generate a Git commit message",
   load: async (args) => {
     return `Generate a concise but descriptive commit message for these changes:\n\n${args.changes}`;
   },
+  name: "git-commit",
 });
 
 server.start({

package/eslint.config.js

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