Best for
- Developers using TypeScript
- Teams needing quick iteration and automatic discovery of tools/resources/prompts
- Projects wanting built-in authentication for MCP servers (JWT, API Key, OAuth 2.1)
M
MCP Framework
Community
A TypeScript framework for building MCP servers elegantly
GitHub source repository ↗
42FMRS · D
mcp-framework is a comprehensive TypeScript MCP framework offering automatic discovery, multiple transports, and authentication options, suitable for quickly building MCP servers. Documentation is thorough and the project is actively maintained by QuantGeekDev, but requires TypeScript knowledge and careful security configuration in production.
mcp-framework is a framework for building Model Context Protocol (MCP) servers in TypeScript. It provides architecture out of the box with automatic directory-based discovery for tools, resources, and prompts, supports multiple transports (stdio, SSE, HTTP Stream), is built on the official MCP SDK, and offers out-of-the-box authentication for SSE endpoints (OAuth 2.1, JWT, API Key).
Tools
The tool list has not been reviewed yet.
Setup
- Install the framework globally: npm install -g mcp-framework
- Create a new MCP server project: mcp create my-mcp-server
- Navigate to your project: cd my-mcp-server
- Your server is ready to use; build with npm run build.
Fit and risk
Not for
- Developers not using TypeScript
- Edge cases requiring non-standard transports or heavy custom authentication
- Users wanting complete control over server internals
Required permissions
- File system access (for logging, if enabled)
- Network access (for SSE/HTTP transports and authentication services)
Risks and side effects
- Token leakage risk when relying on external OAuth providers
- Wildcard CORS may increase cross-origin attack surface
- Skipping tool validation may lead to incomplete documentation
Troubleshooting
- If build fails with tool validation errors, ensure every Zod field has a description using .describe()
- If server won't start, check environment variables like MCP_ENABLE_FILE_LOGGING
- If using OAuth auth, ensure all OAuth environment variables (e.g., OAUTH_JWKS_URI) are set
Use cases
Rapidly scaffold MCP server prototypes
Create custom tools, resources, and prompts for AI assistants
Integrate into TypeScript projects with type safety and automatic validation
Supported clients
Claude DesktopFull support