py-mcp-server-テンプレート
このリポジトリは、Pythonで独自のMCP(モデルコンテキストプロトコル)サーバーを作成するのに役立つテンプレートです。始めるには、このリポジトリをフォークしてください。
UVを使ったセットアップ
このプロジェクトでは、Pythonのパッケージングと仮想環境の管理にuv
を使用しています。UV uv
インストールされていない場合は、公式のUVインストールガイドを参照してください。
- フォークしたリポジトリをクローンします。
- **仮想環境を作成してアクティブ化します。**通常、
uv
プロジェクト ルートに.venv
ディレクトリを作成します。 - **依存関係のインストール:**このプロジェクトは、依存関係を管理するために
pyproject.toml
を使用します。新しい依存関係を追加する場合は、pyproject.toml
ファイルで定義し、このコマンドを再度実行してください。何らかの理由でrequirements.txt
ファイルを使用している場合は、uv pip install -r requirements.txt
でインストールできます。
サーバーの実行
mcp_server.py
スクリプトは MCP サーバーを起動します。
サーバーを直接実行するには:
Claude DesktopまたはCursorとの統合
このMCPサーバーをClaude DesktopやCursorなどのアプリケーションで使用するには、アプリケーションの設定で設定する必要があります。設定には通常、サーバーを実行するコマンドの指定が含まれます。
設定例を以下に示します。/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME /ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME
システム上のプロジェクトディレクトリへの実際の絶対パスに置き換える必要があります。
構成の説明:
"my-custom-python-server"
: これはサーバー構成に付ける名前です。"command": "uv"
: 実行するコマンドとしてuv
を指定します。"args"
:uv
コマンドの引数のリスト:"run"
: 管理対象環境内でコマンドを実行するようにuv
に指示します。"--python"
: 使用するPythonインタープリタを指定します。UVuv
環境(.venv/bin/python
)内のPythonインタープリタを指定することが重要です。"/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/mcp_server.py"
: サーバー スクリプトへの絶対パス。
"workingDirectory"
: サーバー プロセスの作業ディレクトリを指定します。これはプロジェクトのルート ディレクトリである必要があります。
重要:
args
とworkingDirectory
内のパスがシステムに対して正しいことを確認してください。- アプリケーションが
uv
を見つけられない場合は、"command"
フィールドにフルパスを指定する必要があるかもしれません。通常、macOSまたはLinuxのターミナルでwhich uv
実行するか、Windowsの場合はwhere uv
実行することで、このパスを見つけることができます。 - サーバーは、
mcp_server.py
(mcp.run(transport='stdio')
) で設定されているとおり、デフォルトでstdio
をリッスンします。これは通常、Cursor などのアプリケーションが期待するものです。
設定後、アプリケーションは Python MCP サーバーと通信できるようになります。
This server cannot be installed
Claude Desktop や Cursor などのアプリケーションと統合できる、Python でカスタム モデル コンテキスト プロトコル (MCP) サーバーを作成するためのテンプレート リポジトリです。
Related MCP Servers
- -securityAlicense-qualityA Python-based server that implements the Model Context Protocol to interface with Claude Desktop as an MCP client, supporting interaction through efficient memory management.Last updated -1PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -484TypeScript
- -securityAlicense-qualityA streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.Last updated -14PythonMIT License
- -securityFlicense-qualityA starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.Last updated -TypeScript