Jewei MSS MCP Server

项目介绍

这是一个基于FastMCP框架开发的MCP服务器，专门用于执行针对Microsoft SQL Server的数据查询和表结构查询。该服务器提供了一系列工具，使客户端能够轻松地与SQL Server数据库进行交互。

特性

• 数据查询：执行SQL查询并返回结果集
• 表结构查询：获取数据库表的结构信息
• 易于使用：通过MCP协议提供标准化接口
• 高效可靠：优化的数据库连接管理

技术架构

该项目基于以下技术构建：

• FastMCP：一个用于构建MCP服务器的Python框架
• Python：主要开发语言
• Microsoft SQL Server：目标数据库系统
• MCP协议：客户端与服务器之间的通信协议

MCP配置

该项目支持通过多个客户端配置MCP服务器以集成到各种IDE或工具中。这里是一些常见的客户端配置示例：

Windsurf / Cursor / Claude

对于基于Windsurf框架的客户端，如cursor和Claude，您可以在~/.codeium/windsurf/mcp_config.json文件中配置MCP服务器。这里是一个示例配置：

{
  "mcpServers": {
    "jewei-mssql": {
      "disabled": false,
      "command": "uvx",
      "args": [
        "jewei-mssql-mcp-server"
      ],
      "env": {
        "DB_HOST": "your_db_host",
        "DB_USER": "your_db_user",
        "DB_PASSWORD": "your_db_password",
        "DB_NAME": "your_db_name",
        "DB_PORT": "your_db_port"
      }
    }
  }
}

请将your_db_host、your_db_user、your_db_password和your_db_name替换为您实际的数据库连接信息。

Cline

对于Cline客户端，您可以在其配置文件中添加类似的MCP服务器配置。请参阅Cline官方文档以了解具体的配置方法。通常，您需要指定服务器名称、命令、参数和环境变量。

// Cline 配置文件示例 (具体格式请参考 Cline 文档)
{
  "mcpServers": {
    "jewei-mssql": {
      "command": "uvx",
      "args": [
        "jewei-mssql-mcp-server"
      ],
      "env": {
        "DB_HOST": "your_db_host",
        "DB_USER": "your_db_user",
        "DB_PASSWORD": "your_db_password",
        "DB_NAME": "your_db_name",
        "DB_PORT": "your_db_port"
      }
    }
  }
}

请将示例中的占位符替换为您实际的数据库连接信息，并根据Cline的具体配置格式进行调整。

安装与配置

前提条件

• Python 3.7+
• 访问Microsoft SQL Server
• FastMCP库

安装步骤

方法1：通过PyPI安装（推荐）

pip install jewei-mssql-mcp-server

方法2：从源代码安装

1. 克隆此仓库

   git clone [仓库URL]
   cd jewei-mssql-mcp-server
   

2. 安装依赖项

   pip install -r requirements.txt
   

3. 配置数据库连接

   • 创建配置文件或设置环境变量（请参见下文的具体配置方法）

使用说明

启动服务器

python server.py

默认情况下，服务器使用STDIO传输机制。如果需要HTTP传输，可以修改server.py中的相关配置。

客户端调用示例

任何支持MCP协议的客户端都可以连接到此服务器。这里是一个基本的调用示例：

from fastmcp import Client

# 连接到MCP服务器
client = Client("http://localhost:9000")

# 执行SQL查询
result = client.call("query_sql", sql="SELECT * FROM users LIMIT 10")
print(result)

# 获取表结构
structure = client.call("get_table_structure", table_name="users")
print(structure)

配置选项

服务器配置可以通过以下方式设置：

1. 环境变量
2. 配置文件
3. 直接在代码中设置
4. 通过UV配置MCP服务器

使用UV技术安装和管理依赖项

该项目支持使用UV（一种快速的Python包管理器）来安装和管理依赖项。使用UV可以显著提高包安装速度并确保环境一致性。

首先，安装UV：

# 安装uv
pip install uv

然后使用UV创建虚拟环境并安装依赖项：

# 创建虚拟环境
uv venv

# 激活虚拟环境
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate

# 使用uv安装依赖
uv pip install -r requirements.txt

安装完成后，您可以按照以下方式启动MCP服务器：

python server.py

您也可以在~/.codeium/windsurf/mcp_config.json文件中配置服务器以集成到Cascade。该项目支持使用uvx命令来配置MCP服务器：

{
  "mcpServers": {
    "jewei-mssql": {
      "disabled": false,
      "command": "uvx",
      "args": [
        "jewei-mssql-mcp-server"
      ],
      "env": {
        "DB_HOST": "your_db_host",
        "DB_USER": "your_db_user",
        "DB_PASSWORD": "your_db_password",
        "DB_NAME": "your_db_name"
      }
    }
  }
}

其中，uvx是用于运行已安装Python包的命令，jewei-mssql-mcp-server是包名。这种方法确保MCP服务器在正确的环境中运行。

主要配置项

主要配置项包括：

• 数据库连接信息（服务器地址、用户名、密码、数据库名称）
• 服务器监听地址和端口
• 日志级别

贡献指南

欢迎贡献代码或提出改进建议！请遵循以下步骤：

1. 分叉本仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建Pull Request

许可证

[指定许可证类型]

联系信息

如果您有任何问题或建议，请联系 [联系方式]。