MCP Framework

Name: MCP Framework
Author: QuantGeekDev

@QuantGeekDev

リポジトリホームページ

MCP Framework について

The Typescript MCP Framework

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

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

QuantGeekDev

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.