MCP Server Example

🚀 MCP サーバーのサンプル実装

このリポジトリには、教育目的での Model Context Protocol (MCP) サーバーの実装が含まれています。このコードは、様々な LLM クライアントと統合可能な機能的な MCP サーバーを構築する方法を示しています。

完全なチュートリアルを見るには、YouTube ビデオチュートリアルを参照してください。

✨ 主な機能

何が MCP ですか？

MCP（モデルコンテキストプロトコル）は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は、USB - C ポートのように、AI アプリケーションがさまざまなデータソースやツールに接続するための標準的な方法を提供します。

主要な利点

• 事前構築された統合のリストが増え続けており、LLM はそれらを直接使用できます。
• 異なる LLM プロバイダーやサプライヤー間を簡単に切り替えることができます。
• 独自のインフラストラクチャ内でデータを保護するためのベストプラクティスが備わっています。

🔧 技術詳細

アーキテクチャの概要

MCP はクライアント - サーバーアーキテクチャを採用しており、ホストアプリケーションは複数のサーバーに接続できます。

• MCP ホスト：Claude Desktop、IDE、AI ツールなど、MCP データにアクセスしたいアプリケーションです。
• MCP クライアント：サーバーと 1 対 1 の接続を維持するプロトコルクライアントです。
• MCP サーバー：標準化されたモデルコンテキストプロトコルを介して特定の機能を公開する軽量なプログラムです。
• データソース：ローカル（ファイル、データベース）およびリモートサービス（API）など、MCP サーバーがアクセスできるものです。

MCP の核心概念

MCP サーバーは、主に 3 種類の機能を提供できます。

• リソース：クライアントが読み取ることができるファイルのようなデータ（API 応答やファイル内容など）です。
• ツール：LLM が呼び出すことができる関数（ユーザーの承認が必要）です。
• プロンプト：特定のタスクを完了するのを助ける事前に書かれたテンプレートです。

📦 インストール

システム要件

• Python 3.10 以上
• MCP SDK 1.2.0 以上
• uv パッケージマネージャー

クイックスタート

uv パッケージマネージャーのインストール

MacOS/Linux では、次のコマンドを実行します。

curl -LsSf https://astral.sh/uv/install.sh | sh

uv コマンドを有効にするために、ターミナルを再起動してください。

プロジェクトの設定

1. プロジェクトを作成して初期化します。

# 新しいディレクトリを作成してプロジェクトを初期化
uv init mcp-server
cd mcp-server

# 仮想環境を作成してアクティブ化
uv venv
source .venv/bin/activate  # Windows では：.venv\Scripts\activate

2. 依存関係をインストールします。

uv add "mcp[cli]" httpx

3. サーバー実装ファイルを作成します。

touch main.py

サーバーの起動

1. MCP サーバーを起動します。

uv run main.py

2. サーバーが起動し、接続を受け入れる準備ができます。

Claude Desktop への接続

1. 公式ウェブサイトから Claude Desktop をインストールします。
2. Claude Desktop が MCP サーバーを使用するように設定します。 ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # uv コマンドの絶対パスを使用することをおすすめ
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Claude Desktop を再起動します。

トラブルシューティング

Claude Desktop がサーバーを検出できない場合：

1. 設定ファイルのパスと権限を確認してください。
2. 設定内の絶対パスが正しいことを確認してください。
3. uv が正しくインストールされ、アクセス可能であることを確認してください。
4. Claude Desktop のログを確認してエラー情報を取得してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。