MCP Server 101

🚀 MCP サーバー設定ドキュメント

このガイドは、Claude Desktop と統合する Model Control Protocol (MCP) サーバーの設定に関する詳細な説明を提供します。MCP サーバーは、外部システムや API（AWS サービスや GitHub を含む）との相互作用を可能にすることで、Claude の機能を拡張します。

🚀 クイックスタート

前提条件

• Python 3.8 以上をインストールする
• Claude Desktop アプリケーションをインストールする
• uv パッケージマネージャーをインストールする
• Python とコマンドライン操作に関する基本的な知識があること

インストール手順

1. 必要なパッケージのインストール

以下のコマンドを実行して、uv を使用して必要なパッケージをインストールします。

uv add MCP --platforms linux/x86_64,linux/arm64,osx/x86_64,osx/arm64,win/x86_64,win/arm64

2. MCP 設定ファイルの作成

~/.config/mcp/config.json ファイルを作成し、以下の内容を追加します。

{
    "version": "1.0",
    "servers": {
        "local": {
            "host": "localhost",
            "port": 5005,
            "type": "grpc"
        }
    },
    "apis": {
        "aws": {
            "region": "us-east-2",
            "access_key_id": "YOUR_ACCESS_KEY_ID",
            "secret_access_key": "YOUR_SECRET_ACCESS_KEY"
        },
        "github": {
            "token": "YOUR_GITHUB_TOKEN"
        }
    }
}

3. MCP サーバーの起動

ターミナルで以下のコマンドを実行して、MCP サーバーを起動します。

uv run MCP --server local

サーバーのテスト

MCP サーバーが正常に動作していることを確認します。

curl http://localhost:5005/ping

期待される出力：

{
    "status": "success",
    "message": "MCP server is running"
}

Claude Desktop の設定

1. 設定の開き方

Claude Desktop で、Edit > Settings に移動します。

2. MCP サーバーの追加

Services タブで、Add Service をクリックし、以下の情報を入力します。

• Name: MCP Server
• Type: Custom
• URL: http://localhost:5005

3. 設定の適用

Add をクリックして、設定を完了します。

✨ 主な機能

高度な設定

環境変数

ターミナルで以下のコマンドを実行して、環境変数を設定します。

export MCP_API_KEY="your_api_key"

カスタム依存関係

~/.config/mcp/config.json ファイルを編集し、カスタム依存関係を追加します。

{
    "dependencies": {
        "custom-package": "^1.0.0"
    }
}

以下のコマンドを実行して、依存関係をインストールします。

uv run MCP --install

エラー処理

~/.config/mcp/errors.log ファイルでエラーログを確認します。

トラブルシューティング

問題：サーバーに接続できない

解決策： サーバーの状態を確認します。

curl http://localhost:5005/ping

ファイアウォールがポート 5005 のトラフィックを許可していることを確認してください。

問題：設定ファイルが無効

解決策： config.json ファイルの形式が正しいことを検証し、必要に応じて JSON 検証ツールを使用して確認します。

💻 使用例

基本的な使用法

AWS 統合

import boto3

def list_ec2_instances():
    ec2 = boto3.client('ec2', region_name='us-east-2')
    instances = ec2.describe_instances()
    return instances['Reservations']

GitHub 統合

import os
from github import Github

def get_repository_info(repo):
    g = Github(os.getenv("GITHUB_TOKEN"))
    repo = g.get_repo(repo)
    return repo.raw_data

📄 ライセンス

セキュリティに関する注意事項

• コード内で機密情報をハードコードしないでください。
• 環境変数を使用して機密データを保存してください。
• MCP サーバーに認証メカニズムを導入することを検討してください。
• ネットワーク上に公開される機能のセキュリティに注意してください。

リソース

• MCP ドキュメント