MCP Demo

MCP デモ

このリポジトリには、Model Context Protocol（MCP）サーバーのデモ実装が含まれています。このサーバーは、組織とデバイスを管理し、デバイスと関連する組織との距離を計算し、データを操作するための一連のツールを提供するように設計されています。

機能

• データベース統合：PostgreSQL データベースに接続し、組織とデバイスを管理します。
• 距離の計算：ハーバーサインの公式を使用して、デバイスと関連する組織との距離を計算します。
• MCP ツール：組織やデバイスの取得、距離の計算を行うツールを提供します。

前提条件

• Python 3.12.5
• PostgreSQL データベース

セットアップ

1. リポジトリをクローンします：

   git clone <repository-url>
   cd mcp-demo
   

2. 仮想環境をセットアップします：

   uv venv
   source .venv/bin/activate
   

3. .env ファイルで環境変数を設定します：

   DB_NAME=mcp
   DB_USER=mcp_user
   DB_PASSWORD=pa$$word
   DB_HOST=localhost
   DB_PORT=5432
   

4. データベースをセットアップします：

   psql -U <username> -d <database> -f tables.sql
   

使い方

1. MCP サーバーを実行します：

   uv run main.py
   

2. 提供されているツールを使ってサーバーを操作します：

   • get_organizations：データベースからすべての組織を取得します。
   • get_devices：データベースからすべてのデバイスを取得します。
   • get_devices_by_organization：特定の組織のデバイスを取得します。
   • list_devices_with_distance：デバイスと、関連する組織からの距離を一覧表示します。

プロジェクト構成

• main.py：MCP サーバーのメインエントリーポイントです。
• tables.sql：データベーススキーマを設定し、シードデータを追加する SQL スクリプトです。
• .env：データベース設定用の環境変数です。
• pyproject.toml：プロジェクトのメタデータと依存関係です。

依存関係

• httpx：Python 用の HTTP クライアントです。
• mcp[cli]：サーバー構築用の MCP フレームワークです。
• psycopg2：Python 用の PostgreSQL データベースアダプターです。

Claude Desktop の MCP サーバー設定

この MCP サーバープロジェクト用に Claude Desktop を設定するには、次の手順に従います：

1. 公式サイトから Claude Desktop をマシンにインストールします。

2. Claude Desktop を開き、設定メニューに移動します。

3. MCP サーバーの新しいプロジェクト設定を追加します：

    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

4. MCP サーバーを追加します

{
    "mcpServers": {
        "devices": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-demo",
                "run",
                "main.py"
            ],
            "env": {
                "DB_NAME": "mcp",
                "DB_USER": "mcp_user",
                "DB_PASSWORD": "pa$$word",
                "DB_HOST": "localhost",
                "DB_PORT": "5432"
            }
        }
    }
}

5. 次のようなクエリを実行します：List the devices in DB and show me how far are they from their organization address. Also, add get the mac addresses of the devices.