Claude MCP Servers Collection

Claude MCP サーバーコレクション

このリポジトリには、外部のデータソースや API に接続して Claude の機能を拡張する、Model Context Protocol（MCP）サーバーのコレクションが含まれています。これらのサーバーを使うと、Claude は天気予報、映画データ、大学情報などのリアルタイム情報にアクセスできます。

📋 内容

• 天気サーバー：National Weather Service API を使って、リアルタイムの天気予報や警報を取得します
• TMDB 映画サーバー：The Movie Database API を介して、映画やテレビ番組の情報にアクセスします
• Amity University クローラー：Amity University Bengaluru のウェブサイトから情報を抽出して検索します
• ファイルシステムサーバー：ローカルファイルシステム上のファイルにアクセスして管理します

🛠️ 前提条件

これらの MCP サーバーをセットアップする前に、次のいずれかがインストールされていることを確認してください。

• Docker（簡単にセットアップできるため推奨）
  • Windows／Mac 用 Docker Desktop、または Linux 用 Docker Engine
  • その他の依存関係は不要です

または、Docker を使わずに実行する場合：

• Python 3.10+
• Git
• uv - 高速な Python パッケージインストーラーおよび依存関係リゾルバー

UV installation --> https://docs.astral.sh/uv/getting-started/installation/

🚀 はじめに

オプション 1：Docker を使用する（推奨）

手順 1：Docker イメージをプルする

# Pull the Weather MCP server
docker pull kunalondock/mcp-weather:pythonv1

# Pull the TMDB Movie MCP server
docker pull kunalondock/mcp-movie:pythonv1

# Pull the Amity University MCP server
docker pull kunalondock/mcp-amity:pythonv1

# Pull the Filesystem MCP server
docker pull kunalondock/mcp-filesystem:pythonv1

手順 2：Claude Desktop を設定する

以下の「Claude Desktop への接続」セクションに進み、Docker の設定を使用してください。

オプション 2：Python で手動セットアップする

手順 1：リポジトリをクローンする

# Clone the repository
git clone https://github.com/kunalworldwide/mcp_server_demo.git

# Navigate to the project directory
cd mcp_server_demo

手順 2：uv をインストールする（まだの場合）

macOS/Linux：

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

Windows：

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

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

手順 3：各サーバーをセットアップする

天気サーバー

# Navigate to the weather directory
cd weather

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
uv run weather.py

TMDB 映画サーバー

# Navigate to the tmdb directory
cd ../movieinfo/tmdb

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Open tmdb.py and replace YOUR_API_KEY_HERE with your TMDB API key
# You can get a free API key at https://www.themoviedb.org/settings/api

# Test the server
uv run tmdb.py

Amity University クローラー

# Navigate to the amity_crawler directory
cd ../../amity_crawler/amitycrawler

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
uv run amity_crawler.py

🔌 Claude Desktop への接続

これらのサーバーを Claude Desktop に接続するには、Claude Desktop アプリケーションを設定する必要があります。

手順 1：Claude Desktop 設定ファイルを開く

設定ファイルは次の場所にあります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Roaming\Claude\claude_desktop_config.json

ファイルが存在しない場合は作成してください。

手順 2：サーバー設定を追加する

オプション 1：Docker の設定（推奨）

ビルド済みの Docker イメージを使用するには、次の内容を claude_desktop_config.json ファイルに追加します。

{
    "mcpServers": {
        "weather": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "kunalondock/mcp-weather:pythonv1"
            ]
        },
        "tmdb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "-e", "TMDB_API_KEY=46c00bf3aa4f426c510c4b3a026c29d6",
                "--rm",
                "kunalondock/mcp-movie:pythonv1"
            ]
        },
        "amity": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=volume,src=amity-data,dst=/app/amity_data",
                "kunalondock/mcp-amity:pythonv1"
            ]
        },
        "filesystem": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=bind,src=C:\\path\\to\\your\\files,dst=/projects/files",
                "kunalondock/mcp-filesystem:pythonv1",
                "/projects"
            ]
        }
    }
}

注意：

• ファイルシステムサーバーでは、C:\\path\\to\\your\\files を、Claude にアクセスさせたいディレクトリの Windows パスに置き換えてください
• macOS/Linux では、適切なパス形式を使用してください：/path/to/your/files
• TMDB API キーは事前に設定されていますが、必要に応じて独自のキーに置き換えることができます

オプション 2：ローカル Python の設定

Docker を使用せず、Python でサーバーをローカルにセットアップした場合は、代わりに次の設定を使用してください。

{
    "mcpServers": {
        "weather": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/weather",
                "run",
                "weather.py"
            ]
        },
        "tmdb": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/movieinfo/tmdb",
                "run",
                "tmdb.py"
            ]
        },
        "amity": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/amitycrawler",
                "run",
                "amity_crawler.py"
            ]
        }
    }
}

/path/to/your/uv を、uv 実行可能ファイルの実際のパスに置き換えてください。次のコマンドを実行すると確認できます。

which uv  # On macOS/Linux

(Get-Command uv).Source #On Windows

また、/absolute/path/to/mcp_server_demo を、リポジトリをクローンした場所の絶対パスに置き換えてください。

手順 3：Claude Desktop を再起動する

設定ファイルを保存した後、変更を反映するために Claude Desktop を再起動してください。

🔍 サーバーをテストする

接続したら、次のような質問を Claude にして、各サーバーをテストできます。

• 天気サーバー：

  • 「サクラメントの天気はどうですか？」
  • 「テキサス州に気象警報は出ていますか？」

• TMDB 映画サーバー：

  • 「現在人気の映画は何ですか？」
  • 「最近の SF 映画について教えてください。」
  • 「今、人気のテレビ番組は何ですか？」

• Amity University サーバー：

  • 「Amity University Bengaluru ではどのようなコースを提供していますか？」
  • 「コンピューターサイエンス学科の教員は誰ですか？」
  • 「Amity University の入学手続きについて教えてください。」

• ファイルシステムサーバー：

  • 「ダウンロードフォルダーにはどのようなファイルがありますか？」
  • 「file.txt の内容を読んでください」
  • 「claude-files という名前の新しいディレクトリを作成してください」

🔧 トラブルシューティング

問題が発生した場合は、次の解決策をお試しください。

• Docker が起動していない：

  • Docker Desktop または Docker Engine が起動していることを確認してください
  • docker run hello-world でシンプルな Docker コンテナーを実行できるか確認してください

• Docker イメージが見つからない：

  • docker images | grep kunalondock でイメージを取得済みか確認してください
  • 見つからない場合は、docker pull コマンドをもう一度実行してください

• Claude Desktop にサーバーが表示されない：

  • claude_desktop_config.json に構文エラーがないか確認してください
  • 設定内のパスが正しいことを確認してください
  • Claude Desktop を完全に終了してから再起動してください

• ツールの呼び出しに失敗する：

  • Claude のログにエラーがないか確認してください
  • Docker が必要なファイルやディレクトリにアクセスできることを確認してください
  • 正しいパスを設定していることを確認してください

• Claude のログの確認：

  • macOS：~/Library/Logs/Claude/ にあるログファイルを確認してください
  • Windows：%APPDATA%\Claude\Logs\ にあるログファイルを確認してください

🤝 貢献

これらのサーバーを改善したり、新しいサーバーを追加したりしていただけます。アイデアの例：

• より詳しい天気情報を追加する
• 映画データベースを拡張して、レビューやおすすめ情報を含める
• 大学情報のソースを追加する

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• Claude と Model Context Protocol を作成した Anthropic
• modelcontextprotocol.io の MCP ドキュメント
• 公開 API を提供する National Weather Service と TMDB
• 教育情報を提供する Amity University Bengaluru

---

AI を活用した開発をお楽しみください！ 🚀