modelcontextprotocol / modelcontextprotocol/python-sdk

[Feature] De-couple Starlette from FastMCP to make it easier to implement MCP endpoints in other frameworks

オープン
#622 コメント 1 件 リアクション 15 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

enhancement needs decision P3 v2
主要言語
Python
スター
24.3k
フォーク
4k
平均マージ
1日 1時間
マージ済み PR(30日)
31

説明

If someone wanted to implement an MCP server in another framework such as Django or some other ASGI implementation, one would have to use the mcp.server.lowlevel.Server class and implement handlers for the low-level server. This means we have to sacrifice a ton of functionality from FastMCP that really has nothing to do with the python server backend. For example tool/resource/prompt managers, decorators, etc would have to be re-impemented.

It seems that these features of FastMCP could be decoupled in to a base class or mixin that handles all the tool/resource/prompt management & decorators, as well as the integration with the low-level Server. You could then extend that class to implement your own server with all the routing and request/response logic.

The proposed base class would have minimal dependencies on these framework-specific concerns:

Base Class Dependencies:

  • MCPServer from mcp.server.lowlevel.server
  • Tool/Resource/Prompt managers
  • Basic handler methods (list_tools, call_tool, etc.)
  • The decorators (@tool, @resource, @prompt)

Server-specific Responsibilities:

  • Settings handling (Settings class with HTTP config)
  • Transport logic (stdio vs SSE)
  • Routing (custom_route, Starlette routing)
class FastMCPBase:
    """Base class or mixin with tool/resource/prompt management and core handlers"""
    
    def __init__(self, name: str, instructions: str = None):
        self._mcp_server = MCPServer(name=name, instructions=instructions)
        self._tool_manager = ToolManager()
        self._resource_manager = ResourceManager()
        self._prompt_manager = PromptManager()
        self._setup_handlers()
    
    # All the @tool, @resource, @prompt decorators
    # All the list_tools, call_tool, etc. handler methods
    # Context management

class FastMCP(FastMCPBase):
    """Starlette-specific implementation"""
    
    def __init__(self, name: str, **settings):
        super().__init__(name)
        self.settings = Settings(**settings)
        self._custom_starlette_routes = []
    
    # Only Starlette-specific methods like sse_app, routing, etc.

The implementation in the other library could look like this:

class DjangoMCP(FastMCPBase):
    """Django-specific implementation"""
    # Django-specific routing & transport logic

One slight complication could be the Context class as it has a reference to the FastMCP instance (self._fastmcp. However the only function that's used is read_resource which would already be on the base class. So possible just need to change the type hint to use the base class.

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

Issue に記載されている MCPServer の低レベル統合、tool/resource/prompt managers、デコレータ、および handler メソッドを確認します。Context の FastMCP 参照を含め、Starlette 固有の設定、トランスポート、ルーティングを、提案されている FastMCPBase の境界と比較します。完了の条件は、framework に依存しないコードがこれらの機能を保持し、FastMCP が Starlette に関する処理を保持していることです。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
django, python
領域
api, backend
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
30/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。