Ejemplo de Servidor MCP

MCP サーバーの例

このリポジトリには、Model Context Protocol（MCP）サーバーの実装が含まれています。 このコードは、さまざまな大規模言語モデル（LLM）クライアントと統合できる、機能的なMCPサーバーの構築方法を示します。

MCPとは？

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

主なメリット

• LLMが直接利用できる、事前構築済みの統合が増え続けています。
• LLMのプロバイダーやベンダーを柔軟に切り替えられます。
• 自社のインフラストラクチャ内でデータを保護するためのベストプラクティスを利用できます。

アーキテクチャの概要

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

• MCPホスト：Claude Desktop、IDE、またはMCP経由でデータにアクセスするAIツールなどのプログラムです。
• MCPクライアント：サーバーと1対1の接続を維持するプロトコルクライアントです。
• MCPサーバー：Model Context Protocol経由で特定の機能を公開する軽量なプログラムです。
• データソース：MCPサーバーがアクセスできるローカルデータ（ファイル、データベース）とリモートサービス（API）の両方です。

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

Windowsの場合：

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

インストール後、uvコマンドを利用できるよう、必ずターミナルを再起動してください。

プロジェクトの設定

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

# Crear un nuevo directorio para el proyecto
uv init mcp-server
cd mcp-server

# Crear y activar el entorno virtual
uv venv
source .venv/bin/activate  # En Windows: .venv\Scripts\activate

# Instalar dependencias
uv add "mcp[cli]" httpx

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

touch main.py

サーバーの実行

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

uv run main.py

2. サーバーは接続を受け付ける準備が整います。

Claude Desktopへの接続

1. 公式サイトからClaude Desktopをインストールします。
2. MCPサーバーを使用するようClaude Desktopを設定します。

ファイル ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/RUTA/ABSOLUTA/A/TU/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

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

トラブルシューティング

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

1. 設定ファイルのパスと権限を確認します。
2. 設定内の絶対パスが正しいことを確認します。
3. uvがインストールされ、利用可能であることを確認します。
4. Claude Desktopのログを確認し、エラーがないか調べます。

ライセンス

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

連絡先

• Leandro Rivera：[email protected]
• Linkedin：https://www.linkedin.com/in/leandrorivera/

コーディングをお楽しみください！ 🚀

このプロジェクトが役に立ったら、GitHubで⭐を付けてください！ 😊