MCP Demo

MCP 演示

此仓库包含一个模型上下文协议（MCP）服务的演示实现。该服务旨在管理组织和设备，计算设备与其所属组织之间的距离，并提供一组用于与数据交互的工具。

功能

• 数据库集成：连接到 PostgreSQL 数据库，以管理组织和设备。
• 距离计算：使用 Haversine 公式计算设备与其所属组织之间的距离。
• 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.