MCP Framework

What is MCP Framework?

MCP Framework is a TypeScript framework for building Model Context Protocol (MCP) servers. It provides automatic directory-based discovery of tools, resources, and prompts, along with a CLI for project scaffolding. The framework is designed for developers who want to create MCP servers with minimal boilerplate and built-in validation.

How to use MCP Framework?

Install the framework globally with npm install -g mcp-framework, then create a project using mcp create my-mcp-server. Add tools, prompts, or resources with mcp add tool <name>, mcp add prompt <name>, or mcp add resource <name>. Build and validate with npm run build. Serve the server with node dist/index.js and configure MCP clients (e.g., Claude Desktop) by pointing to the built dist/index.js.

Key features of MCP Framework

• Automatic discovery and loading of tools, resources, and prompts
• Multiple transport support: stdio, SSE, and HTTP Stream
• TypeScript-first development with full type safety
• Built on the official MCP SDK
• Easy-to-use base classes for tools, prompts, and resources
• Out-of-the-box authentication for SSE endpoints (OAuth 2.1, JWT, API Key)

Use cases of MCP Framework

• Build custom MCP servers with structured tool, resource, and prompt management
• Develop AI‑assistant integrations that use MCP to expose actions (e.g., crypto tipping via tip.md)
• Rapidly prototype and deploy MCP servers for Claude Desktop or other MCP clients

FAQ from MCP Framework

How do I add a new tool to my MCP server?

Use the CLI command mcp add tool <name> from the project root. This generates a skeleton file in the tools/ directory. Define the tool’s schema using a Zod object and implement the execute method.

Which transports does MCP Framework support?

The framework supports stdio (default), SSE, and HTTP Stream. You can enable HTTP transport at creation time with mcp create <project> --http --port 1337 --cors.

How can I validate that my tools have proper descriptions?

Run npm run build (which includes automatic validation) or the standalone command mcp validate. The framework enforces that every Zod schema field has a .describe() call.

Where are log files stored and how can I enable them?

Logging to files is disabled by default. Set the environment variable MCP_ENABLE_FILE_LOGGING=true and optionally MCP_LOG_DIRECTORY (default logs). Debug console output is enabled via MCP_DEBUG_CONSOLE=true.

What authentication options are available for SSE endpoints?

MCP Framework provides built‑in authentication for SSE endpoints using OAuth 2.1, JWT, and API Key mechanisms.