feat(templates): add MCP server project template

[galligan]

• package.json with MCP SDK and @outfitter deps
• StdioServerTransport entry point
• Sample hello tool implementation
• Claude Desktop config in README

Co-Authored-By: Claude Opus 4.5 noreply@anthropic.com

[galligan]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• chore(outfitter): sync templates on pack #108
• chore(changesets): ignore app package #107
• fix(errors): avoid TaggedError extends warnings #106
• chore(release): align package versions to 0.1.0 #105
• docs: add README and CHANGELOG for testing, kit, outfitter #95
• feat(templates): add daemon project template #94
• feat(templates): add MCP server project template #93 👈 (View in Graphite)
• feat(templates): add CLI project template #92
• fix(cli): implement confirmDestructive prompts #104
• fix(cli): implement createCLI and command builder #103
• feat(kit): add @outfitter/kit meta-package #91
• docs(daemon): add README and CHANGELOG #90
• fix(daemon): fix locking module bugs (GREEN phase) #89
• test(daemon): add locking module tests (RED phase) #88
• feat(daemon): add errors, platform, and locking module stubs #87
• feat(outfitter): add doctor command for environment validation #86
• feat(outfitter): add init command with project scaffolding #85
• feat(daemon): add IPC communication and health checks #84
• feat(daemon): add types and lifecycle management #83
• feat(index): add FTS5 full-text search implementation #82
• feat(index): add types for FTS5 full-text search #81
• feat(testing): add MCP and CLI test harnesses #80
• feat(testing): add test fixture utilities #79
• feat(mcp): add MCP server implementation with typed handlers #78
• feat(mcp): add types and interfaces for MCP server #77
• feat(ui): add Shape discriminated union and render() #76
• feat(ui): add createTokens semantic color layer #75
• feat(state): add pagination helpers #74
• feat(logging): add DEFAULT_PATTERNS for common secret redaction #73
• feat(ui): add formatRelative() for human-readable timestamps #72
• feat(state): add encodeCursor/decodeCursor for pagination #71
• feat(types): add hashId() for deterministic short identifiers #70
• feat(contracts): add Logger.child() and fix AssertionError category #69
• feat(config): centralize environment variable access with Zod validation #42
• fix(logging): enable redaction by default when global rules exist #41
• docs(ui): add README, CHANGELOG, and TSDoc comments #39
• docs(state): add README, CHANGELOG, and TSDoc comments #38
• docs(file-ops): add README, CHANGELOG, and TSDoc comments #37
• docs(logging): add README, CHANGELOG, and TSDoc comments #36
• docs(config): add README, CHANGELOG, and TSDoc comments #35
• fix(cli): enforce cursor TTL #114
• fix(tests): remove placeholder tests #113
• chore(gitattributes): prefer ours for bun lockfiles #115
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Summary

• Adds complete MCP server project template to enable scaffolding new MCP projects with standardized structure, dependencies, and configuration
• Implements template structure with Mustache-style variables for project customization ({{projectName}}, {{binName}}, {{description}})
• Includes working "hello" tool example integrated with @outfitter/logging and proper Claude Desktop configuration documentation

Important Files Changed

Filename	Overview
templates/mcp/src/mcp.ts.template	Core MCP server implementation with tool registration and request handling logic
templates/mcp/package.json.template	Project dependencies and build configuration including MCP SDK and @outfitter packages
templates/mcp/src/server.ts.template	Bun-based entry point using StdioServerTransport for MCP server execution

Confidence score: 4/5

• This PR is safe to merge with low risk as it adds new template files without affecting existing functionality
• Score reflects well-structured template implementation following project conventions, though minor improvements could be made to error handling patterns and type safety in the tool dispatch logic
• Pay close attention to templates/mcp/src/mcp.ts.template for the string-based tool dispatch pattern and ensure it follows best practices

Sequence Diagram

sequenceDiagram
    participant User as "User"
    participant Claude as "Claude Desktop"
    participant Server as "MCP Server"
    participant Transport as "StdioServerTransport"
    
    User->>Claude: "Request using hello tool"
    Claude->>Server: "ListToolsRequest"
    Server->>Claude: "Return available tools (hello)"
    Claude->>Transport: "CallToolRequest (hello, args)"
    Transport->>Server: "Route tool call"
    Server->>Server: "Process hello tool with name parameter"
    Server->>Transport: "Return greeting response"
    Transport->>Claude: "Tool response with greeting text"
    Claude->>User: "Display greeting result"

Loading

[greptile-apps]

_{8 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

logic: Setting noEmit: true while also configuring declaration: true and output directories creates conflicting intentions - declarations won't be generated when noEmit is enabled

Suggested change

	"noEmit": true,
	"declaration": true,
	"declarationDir": "dist",
	"outDir": "dist",
	"declaration": true,
	"declarationDir": "dist",
	"outDir": "dist",

Should this template support declaration generation for distribution, or is it purely for development with noEmit?

Prompt To Fix With AI

This is a comment left during a code review.
Path: templates/mcp/tsconfig.json.template
Line: 9:12

Comment:
**logic:** Setting `noEmit: true` while also configuring `declaration: true` and output directories creates conflicting intentions - declarations won't be generated when noEmit is enabled

```suggestion
		"declaration": true,
		"declarationDir": "dist",
		"outDir": "dist",
```

 Should this template support declaration generation for distribution, or is it purely for development with noEmit?

How can I resolve this? If you propose a fix, please make it concise.

[galligan]

Tightened tool dispatch in the template: added a small handler map, argument guards/defaults, and a warn log for unknown tools. Restacked and resubmitted.