MCP Server Python

🚀 MCP サーバーサンプル

このリポジトリには、モデルコンテキストプロトコル (MCP) を実装したサーバーコードが含まれています。このコードは、複数の言語モデルクライアント (LLM) と統合できる機能が完備した MCP サーバーを構築する方法を示しています。

📖 何が MCP ですか？

MCP（Model Context Protocol）は、アプリケーションが言語モデルにコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は、AI アプリケーションの「USB-C ポート」として機能し、さまざまなデータソースやツールを AI モデルに標準的な方法で接続します。

✨ 主な利点

• あなたの LLM で直接使用できる、急速に増えている事前構築済みの統合リスト。
• 異なる LLM ベンダーやプロバイダー間で切り替える柔軟性。
• データ保護のベストプラクティス。

🏗️ アーキテクチャの概要

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

• MCP ホスト：Claude Desktop、IDE、またはその他の AI ツールなど、MCP を通じてデータにアクセスしたいアプリケーション。
• MCP クライアント：サーバーとの単一の接続を維持するプロトコルクライアント。
• MCP サーバー：特定の機能（ファイルアクセスや API 呼び出しなど）を提供する軽量プログラム。
• データソース：ローカルファイル、データベース、またはリモートサービス（API など）であり、MCP サーバーがアクセスできます。

🔑 MCP の重要な概念

MCP サーバーは、3 つの主要なタイプの機能を提供できます。

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

🛠️ システム要件

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

🚀 クイックスタート

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

macOS/Linux：

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

Windows：

iwr -useb https://astral.sh/uv/install.ps1 | iex

インストール後は、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

⚙️ Claude Desktop の設定

MCP サーバーを Claude Desktop と統合するには、以下の手順に従ってください。

1. Claude の設定メニューを開きます。
2. 統合オプションに移動します。
3. MCP サーバーの設定を追加し、パス /ruta/absoluta/para/tu/mcp-server を指定します。

💻 使用例

# MCP サーバーを起動
uv run main.py

📞 連絡先

何か質問やフィードバックがある場合は、以下の方法で連絡してください。

• メール：[あなたのメールアドレス]
• LinkedIn：[あなたの LinkedIn のリンク]

楽しいコーディングを！🚀

このプロジェクトが役に立った場合は、GitHub でスターをつけてください 😊