MCP Framework

Name: MCP Framework
Author: QuantGeekDev

@QuantGeekDev

Repository Homepage

About MCP Framework

The Typescript MCP Framework

#mcp #claude #llm #llms #anthropic #genai #modelcontextprotocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-framework": {
      "command": "node",
      "args": [
        "dist/index.js",
        "#",
        "Server",
        "validates",
        "tools",
        "on",
        "startup"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Developer Tools MCP servers

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K