local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides functionality for managing user profiles, creating and searching posts, and analyzing user data through a simple Python implementation with a local database.

MCP Pythonチュートリアル

モックデータを備えたシンプルなローカル DB を使用した Python の MCP チュートリアルアプリ

インストールと実行

このリポジトリをクローンする
依存関係をインストールします:

pip install -r requirements.txt

MCP サーバーを開発モードで実行します。

mcp dev localdb_app.py

MCPサーバーのデフォルトポートは5173です。http http://localhost:5173にアクセスしてください。

MCPの機能

このチュートリアルアプリは、MCPのコアコンセプトを実証します。tutorial_app /mcp_server.pyでロールごとのアノテーションを確認できます。

`@mcp.resource`

基本的に、このアノテーションは、RESTAPI のGETと同様に、エージェントがリソースを「取得」することに関するものです。

users://all - すべてのユーザーを取得
users://{user_id}/profile - ユーザーのプロフィールを取得する
posts://all - すべての投稿を取得
posts://{post_id} - IDで投稿を取得する

`@mcp.tool`

これは、RESTAPI のPOSTと同様に、エージェントが新しいリソースを「生成」することです。

create_user - 新しいユーザーを作成する
create_post - 新しい投稿を作成する
search_posts - タイトルまたは内容で投稿を検索

`@mcp.prompt`

これは、LLM と便利にやりとりするための再利用可能なテンプレートです。

user_profile_analysis - ユーザーのプロフィールの分析を生成する
post_feedback - 投稿のフィードバックのための対話型プロンプト

[!NOTE] 詳細な注釈については、次をお読みください: https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#core-concepts

クライアントに接続中

MCPサーバーをセットアップしたら、MCPサーバーを使用してエージェントを構築するLLMクライアントが必要です。以下のガイドは、 Claude Desktopをクライアントとして接続する方法を説明します。

Claude Desktopは、MCPサーバーの依存関係をインストールするためにuv使用します。まず、 uvをインストールします。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uvを使用して MCP サーバーの依存関係をインストールします。

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

uv pip install -r requirements.txt

Claude Desktop のダウンロードはこちら:

https://claude.ai/download

claude_desktop_config.jsonファイルを見つけるか作成します。場所は OS によって異なります。

ウィンドウズ:

C:\Users\%USER%\AppData\Roaming\Claude\claude_desktop_config.json

MacOS/Linux:

~/Library/Application\ Support/Claude/claude_desktop_config.json

claude_desktop_config.jsonにmcpServers属性を追加します。

{
    "mcpServers": {
        "local_db": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "localdb_app.py"
            ]
        }
    }
}

注: 複数のMCPサーバーを導入し、それぞれに専用の関心と専門知識を持たせることもできます。関心を分離することは、すべてを単一のMCPサーバーに実装するよりも効果的です。

Claude Desktop を再起動します。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

リソース処理、ツール操作、ローカルデータベースを備えたシンプルなユーザー/投稿システム用の再利用可能なプロンプトを備えた Python での MCP 実装を示すデモサーバーです。

MCP Python Tutorial