mcp-framework  by QuantGeekDev

TypeScript framework for building Model Context Protocol (MCP) servers

created 7 months ago
818 stars

Top 44.3% on sourcepulse

GitHubView on GitHub
Project Summary

This framework provides a structured approach for building Model Context Protocol (MCP) servers using TypeScript. It targets developers creating AI-powered applications that require seamless integration with large language models, offering features like automatic discovery of tools, resources, and prompts, and multiple transport options for flexible deployment.

How It Works

The framework leverages a directory-based discovery mechanism to automatically load and register tools, resources, and prompts. It builds upon the official MCP SDK, providing elegant abstractions for defining these components. The core advantage lies in its TypeScript-first design, ensuring full type safety throughout the development process, and its out-of-the-box support for various transport protocols including stdio, Server-Sent Events (SSE), and HTTP streams.

Quick Start & Requirements

  • Install globally: npm install -g mcp-framework
  • Create a new project: mcp create my-mcp-server
  • Navigate and run: cd my-mcp-server && npm run build && node dist/index.js
  • Prerequisites: Node.js, npm/yarn.
  • Docs: https://github.com/QuantGeekDev/mcp-framework#readme

Highlighted Details

  • CLI for project creation and component generation (mcp create, mcp add tool, etc.).
  • Supports stdio, SSE, and HTTP stream transports with configurable options.
  • SSE and HTTP stream transports offer authentication (JWT, API Key, custom).
  • HTTP stream transport supports batch or stream response modes, session management, and stream resumability.

Maintenance & Community

  • No specific contributors, sponsorships, or community links (Discord/Slack) are mentioned in the README.

Licensing & Compatibility

  • MIT License. Permissive for commercial use and closed-source linking.

Limitations & Caveats

The README mentions an "EXPERIMENTAL HTTP transport" with a note to modify CORS settings if needed. Some advanced features like stream resumability are disabled by default.

Health Check
Last commit

1 month ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
310 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Travis Fischer Travis Fischer(Founder of Agentic), and
1 more.

fastmcp by punkpeye

3.7%
2k
TypeScript framework for building MCP servers handling client sessions
created 7 months ago
updated 2 days ago
Feedback? Help us improve.