MCP 服务器：趋势数据持久化器

本项目使用 Python (fastmcp) 实现了一个模型上下文协议 (MCP) 服务器，用于将趋势数据（上升或下降）持久化到 PostgreSQL 数据库中。

该服务器公开了一个工具 persist-trend-data，它接受：

1. datasource_url: 目标 PostgreSQL 数据库的连接字符串。

2. json_data: 代表趋势的 JSON 对象。它必须匹配以下模式之一：

   • 上升趋势：

     {
       "trend": "upward",
       "rockstars": [
         { "name": "string", "department": "string", "amount": integer },
         ...
       ]
     }
     

   • 下降趋势：

     {
       "trend": "downward",
       "culprits": [
         { "name": "string", "department": "string", "amount": integer },
         ...
       ]
     }
     

功能：

根据 json_data 中的 trend 值：

• 如果 trend 是 "upward"，它会确保存在一个名为 upward_trend_rockstars 的表（包含 id、name、department、amount 列）。然后，它将 rockstars 数组中的数据插入到该表中。
• 如果 trend 是 "downward"，它会确保存在一个名为 downward_trend_culprits 的表（包含相同的列）。然后，它将 culprits 数组中的数据插入到该表中。
• 该工具使用 Pydantic 进行输入验证，并使用 psycopg2 与 PostgreSQL 数据库交互。

前提条件

• Python (建议 >=3.10，如 pyproject.toml 中指定)
• make
• uv (可选，如果未找到 uv，Makefile 将回退到 python -m venv 和 pip)
• 可以访问正在运行的 PostgreSQL 数据库。

设置和运行

为了方便起见，提供了一个 Makefile。

1. 克隆/导航： 进入项目目录：

   cd /path/to/mcp-server-trend-persister
   

2. 运行服务器：

   make
   

   该设置将安装依赖项，运行 MCP 服务器并检查它。此外，MCP 服务器将监听通过标准输入/输出发送的请求。

Makefile 目标

Makefile 中提供了以下目标：

• make install: 创建/更新 .venv 虚拟环境，并使用 uv（首选）或 pip 安装依赖项。
• make run: 使用 .venv 中的 Python 解释器运行 MCP 服务器 (persister.py)。
• make inspect: 使用 MCP 检查器 (npx @modelcontextprotocol/inspector uv run persister.py) 检查 persister.py 中定义的工具。依赖于 install。
• make lint: 运行代码检查器（例如，Ruff、Black）的占位符。
• make clean: 删除虚拟环境、缓存文件和其他构建工件。
• make help: 显示可用目标的列表。

与 MCP 客户端集成

配置您的 MCP 客户端（如上下文中提到的客户端）以连接到此服务器。使用 Makefile 时，启动服务器的命令会简化。

示例配置片段：

{
    "mcpServers": {
        "trend-persister": {
            "command": "make",
            "args": [
                "run" // 要执行的目标
            ],
            "cwd": "/Users/julian/Documents/Code/Learning/MCP/mcp-server-trend-persister" // 重要：设置工作目录
        },
        // ... 其他服务器
    }
}

确保 cwd 路径指向 Makefile 所在的正确项目目录。

示例工具请求

MCP 客户端将发送如下请求：

{
  "toolName": "persist-trend-data",
  "arguments": {
    "datasource_url": "postgresql://your_user:your_password@your_host:5432/your_db",
    "json_data": {
      "trend": "upward",
      "rockstars": [
        { "name": "Alice", "department": "Sales", "amount": 50000 },
        { "name": "Bob", "department": "Engineering", "amount": 60000 }
      ]
    }
  }
}