Spec Kit MCP Server

Instructions

Implementation Reference

• src/index.ts:289-302 (handler)

  The core handler function that executes the logic for the 'speckit_plan' tool. It builds a prompt message directing the LLM to use a template file and generate a technical plan.

  private async handlePlan(commandsPath: string, context?: string) {
      const extraContext = context ? `\nContext: '${context}'` : "";
      return {
          messages: [
              {
                  role: "user",
                  content: {
                      type: "text",
                      text: `Please read the planning template at 'commands/speckit.plan'[Note that if this file exists, it is generally in the current directory's commands/ directory,Scan this folder directly to obtain it,And the suffixes of each project are not consistent: speckit.plan.xxx] [It's important. You must read it]. Analyze the current project to identify the technology stack. Then, using the template and the Context: '${extraContext}', create a technical plan.`,
                  },
              },
          ],
      };
  }

• src/index.ts:206-207 (registration)

  The dispatch/registration case in the CallToolRequestSchema handler that routes 'speckit_plan' calls to the handlePlan function.

  case "speckit_plan":
      result = await this.handlePlan(commandsPath, args.context as string);

• src/index.ts:157-169 (schema)

  The tool definition in ListToolsRequestSchema response, including name, description, and input schema for 'speckit_plan'.

  {
      name: "speckit_plan",
      description: "Create a technical plan",
      inputSchema: {
          type: "object",
          properties: {
              context: {
                  type: "string",
                  description: "Additional context or requirement",
              },
          },
      },
  },

• src/index.ts:107-108 (registration)

  Related dispatch for the prompt version 'speckit.plan' which also uses handlePlan (note the dot vs underscore).

  case "speckit.plan":
      return await this.handlePlan(commandsPath, args.context as string);

• src/index.ts:71-80 (schema)

  The prompt definition in ListPromptsRequestSchema, similar schema for 'speckit.plan'.

      name: "speckit.plan",
      description: "Create a technical plan",
      arguments: [
          {
              name: "context",
              description: "Additional context or requirement",
              required: false,
          },
      ],
  },