SQL Analysis MCP Server

模型上下文协议（MCP）服务器

此项目是实现以下功能的服务器的一个简单示例 模型上下文协议（MCP），在MCP客户端上可用的情况下，使用“采样”进行测试。

先决条件

• Python 3.x
• 紫外线：一个快速的Python包安装程序和解析器。
• fastmcp：用于构建MCP服务器和客户端的库。
• 和npm（使用 npx).

安装

1. 安装依赖项：

使用 uv 从同步项目的依赖关系 pyproject.toml 和 uv.lock。这将安装 fastmcp 以及其他必要的包装。

   uv sync

在开发中运行服务器

要运行服务器并使用MCP检查器工具进行检查，请在终端中执行以下命令。您可以在 官方文件.

npx @modelcontextprotocol/inspector uv run mcp_server.py -- --sql_path /path/to/your/sql/files

此命令执行以下操作：

• npx @modelcontextprotocol/inspector：下载并运行官方MCP检查器。
• uv run mcp_server.py：然后，检查员使用 uv 执行 mcp_server.py 项目托管虚拟环境中的脚本。

检查器将在您的web浏览器中启动，提供与正在运行的MCP服务器交互的用户界面。

在生产环境中运行服务器

在生产环境中，MCP客户端将连接到服务器。客户端需要一个配置来告诉它如何启动服务器并与服务器通信。这通常是通过JSON配置文件完成的。

您可以使用以下命令为此服务器生成JSON配置 fastmcp 命令行工具：

fastmcp install mcp-json mcp_server.py -- --sql_path /path/to/your/sql/files

这将输出一个JSON对象，您可以使用它来配置MCP客户端。此服务器的生成配置如下：

{
  "mcpServers": {
    "sql-analysis-server": {
      "command": "uv",
      "args": ["run", "mcp_server.py", "--", "--sql_path", "/path/to/your/sql/files"],
      "cwd": "/home/your-dev-folder/sql-analysis-mcp-server"
    }
  }
}

此配置通过运行命令告诉客户端启动“sql-analysis-server” uv run mcp_server.py -- --sql_path /path/to/your/sql/files 并使用标准输入/输出与之通信(stdio)运输。