Claude MCP Servers Collection

🚀 クララ MCP プロジェクトドキュメント

このドキュメントは、Claude の Model Context Protocol (MCP) のサンプルプロジェクトをサポートしています。Docker とローカルの Python スクリプトを使用して、Claude の機能を拡張する方法を示しています。天気、TMDB 映画、Amity 大学情報、ファイルシステムアクセスの 4 つのサーバーを提供しています。

🚀 クイックスタート

Docker を使用したサーバーの設定

claude_desktop_config.json ファイルを編集し、以下の設定を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-weather:latest"
      ]
    },
    "tmdb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-tmdb:latest"
      ]
    },
    "amity-university": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-amity:latest"
      ]
    },
    "file-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--mount",
        "type=bind,src=/path/to/files,dst=/projects/files",
        "kunal/mcp-file-system:latest",
        "/projects"
      ]
    }
  }
}

ローカル Python スクリプトを使用したサーバーの設定

claude_desktop_config.json ファイルを編集し、以下の設定を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-weather",
        "run",
        "weather.py"
      ]
    },
    "tmdb": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-tmdb",
        "run",
        "tmdb.py"
      ]
    },
    "amity-university": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-amity",
        "run",
        "amity_crawler.py"
      ]
    }
  }
}

✨ 主な機能

このプロジェクトは、Claude の機能を拡張するために、4 つのサーバーを提供しています。

• 天気サーバー：天気情報を提供します。
• TMDB 映画サーバー：TMDB からの映画情報を提供します。
• Amity 大学サーバー：Amity 大学の情報を提供します。
• ファイルシステムサーバー：ファイルシステムへのアクセスを提供します。

📦 インストール

1. Docker

• インストールガイド：
  • Docker 公式ドキュメント
• インストールの確認：

docker --version

2. UV コマンドツール

• UV の取得：
  • Docker イメージを使用：docker pull ghcr.io/anthropic/uv-cli:latest
  • インストールが完了したら、以下のコマンドでパスを確認します。

which uv # macOS/Linux
(Get-Command uv).Source # Windows

📚 ドキュメント

完全な設定例

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-weather:latest"
      ]
    },
    "tmdb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-tmdb:latest"
      ]
    },
    "amity-university": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-amity:latest"
      ]
    },
    "file-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--mount",
        "type=bind,src=/path/to/files,dst=/projects/files",
        "kunal/mcp-file-system:latest",
        "/projects"
      ]
    }
  }
}

サーバーのテスト

• 天気サーバー：
  • クエリ例："Sacramento の現在の天気はどうですか？"
• TMDB 映画サーバー：
  • クエリ例："現在公開中の映画はどれですか？"
• Amity 大学サーバー：
  • クエリ例："Bengaluru キャンパスではどのようなコースが提供されていますか？"
• ファイルシステムサーバー：
  • クエリ例："ダウンロードフォルダにはどのようなファイルがありますか？"

トラブルシューティング

一般的な問題

1. Docker が動作しない場合

• Docker Desktop または Docker エンジンが起動していることを確認してください。
• docker run hello-world を使用してコンテナの実行をテストしてください。

2. イメージが見つからない場合

• イメージが存在するか確認します：docker images | grep kunal/mcp-
• 必要に応じて、イメージを再取得します。

📄 ライセンス

ドキュメントにライセンス情報は記載されていません。

プロジェクト貢献者

• Kunal Chhabra（@kunalc）

このドキュメントは、Claude の機能を拡張するための詳細なガイドを提供しています。Docker とローカルスクリプトを組み合わせることで、カスタムサーバーを簡単に追加し、対話体験を豊かにすることができます。