MCP Examples

🚀 MCP サーバーチームデプロイメント方案

このプロジェクトでは、チームで使用する Model Context Protocol (MCP) サーバーのデプロイ構成とカスタマイズ実装を探索しています。

🚀 クイックスタート

このセクションでは、MCP サーバーの基本的な使い方を説明します。

✨ 主な機能

• MCP サーバーは Unix ソケットまたは標準入出力を使用して通信します。
• 主にローカルでの使用を想定しており、HTTP/REST API ではなく設計されています。
• チーム全体でのアクセスには追加の統合作業が必要です。
• MCP サーバーは、クライアントの要求に応じて複数のコンテキスト/リソースをサポートします。

📦 インストール

必要な依存関係のインストール

pip install mcp-client

サーバーの起動

mcp_server_git --port 8000

クライアントの使用

# 新しいリポジトリを初期化する
git_init(repo_path="/path/to/repo")

# リポジトリの状態を取得する
git_status(repo_path="/path/to/repo")

💻 使用例

基本的な使用法

# 新しいリポジトリを初期化する
git_init(repo_path="/path/to/repo")

# リポジトリの状態を取得する
git_status(repo_path="/path/to/repo")

高度な使用法

# チーム全体でのアクセスのために、Kubernetes クラスターに MCP サーバーをデプロイする
kubectl apply -f deployments/git/k8s-deployment.yaml

# サービスを公開する
kubectl expose deployment mcp-server --port 8000

# サービスにアクセスする
kubectl get services
# EXTERNAL-IP を取得し、ブラウザで http://<external-ip>:8000 を開く

📚 ドキュメント

MCP アーキテクチャの理解

• MCP サーバーは通常、Unix ソケットまたは標準入出力を使用して通信します。
• 主にローカルでの使用を想定しており、HTTP/REST API ではなく設計されています。
• チーム全体でのアクセスには追加の統合作業が必要です。
• MCP サーバーは、クライアントの要求に応じて複数のコンテキスト/リソースをサポートします。

プロジェクト構造

.
├── deployments/         # Kubernetes デプロイメント構成（実験的）
│   └── git/             # Git MCP サーバーのデプロイ
│       ├── Dockerfile
│       ├── k8s-deployment.yaml
│       ├── k8s-ingress.yaml
│       ├── deploy.sh
│       └── README.md
│
└── servers/             # カスタム MCP サーバーの実装
    ├── git/             # Git MCP サーバーのカスタム実装（必要な場合）
    │   └── README.md
    └── README.md

推奨方法

個人開発（簡単）

1. 必要なライブラリとツールをインストールします。
2. サーバーを起動します。

mcp_server_git --port 8000

3. クライアントを使用します。

# 新しいリポジトリを初期化する
git_init(repo_path="/path/to/repo")

# リポジトリの状態を取得する
git_status(repo_path="/path/to/repo")

チーム全体でのアクセス

1. Kubernetes クラスターに MCP サーバーをデプロイします。
2. クライアントの設定を更新します。

mcp_client --server_url http://mcp-server.example.com

3. 認証と承認メカニズムを実装して、チームメンバーの安全なアクセスを確保します。

Cursor との統合（例）

新しいツール my_plugin を開発しており、MCP サーバーとやり取りする必要があるとします。

ステップ 1: 依存関係のインストール

pip install mcp-client

ステップ 2: 設定

プロジェクトのルートディレクトリに mcp_config.json を作成します。

{
  "server_url": "http://mcp-server.example.com",
  "api_key": "your_api_key_here"
}

ステップ 3: プラグインの実装

from mcp_client import MCPClient

client = MCPClient()
response = client.git_status(repo_path="/path/to/repo")
print(response.status)

実験的な Kubernetes デプロイメント

1. サーバーをデプロイします。

kubectl apply -f deployments/git/k8s-deployment.yaml

2. サービスを公開します。

kubectl expose deployment mcp-server --port 8000

3. サービスにアクセスします。

kubectl get services
# EXTERNAL-IP を取得し、ブラウザで http://<external-ip>:8000 を開く

Git MCP サーバーの機能

1. git_init ツールを使用して新しいリポジトリを作成します。
2. git_status を使用してリポジトリの状態を確認します。
3. git_commit を使用してファイルをリポジトリにコミットします。

例：

# 新しいリポジトリを初期化する
git_init(repo_path="/path/to/new/repo")

# リポジトリの状態を取得する
git_status(repo_path="/path/to/new/repo")

新しい MCP サーバーの追加方法

1. servers/ フォルダの下に新しいフォルダを作成します。例えば my_server/。
2. MCPServer クラスを継承し、必要なメソッドを実装します。
3. メインの README.md ドキュメントを更新して、新しいサーバーの実装を記録します。

トラブルシューティング

エラー: “/repos は有効な Git リポジトリではありません”

問題: ERROR:mcp_server_git.server:/repos は有効な Git リポジトリではありません

解決策:

1. git_init ツールを使用してリポジトリを作成します。

git_init(repo_path="/path/to/repo")

2. 以降の操作でこのパスを指定します。

git_status(repo_path="/path/to/repo")

通信問題

• サーバーが実行中かどうかを確認します。kubectl get pods または ps aux | grep mcp_server_git
• クライアントの設定が正しくターゲットアドレスを指していることを確認します。
• リポジトリディレクトリへのアクセス権を確認します。

次のステップの提案

1. チーム環境に適したカスタム MCP サーバーの実装を探索します。
2. WebSocket または gRPC プロトコルを調査して、ネットワーク通信を実現します。
3. 認証と承認レイヤーを開発します。
4. ネットワークでアクセス可能な MCP サーバーとやり取りできるクライアントアダプターを作成します。

参考資料

• モデルコンテキストプロトコル
• MCP Python SDK
• MCP Git サーバー