What is Jewei Mssql Mcp Server

jewei-mssql-mcp-server is an MCP server developed based on the FastMCP framework, specifically designed for executing data queries and table structure queries on Microsoft SQL Server databases. It provides a set of tools for clients to interact conveniently with SQL Server databases.

Use cases

Use cases for jewei-mssql-mcp-server include: 1) Developers needing to query SQL Server databases from their applications; 2) Data analysts performing data retrieval and analysis; 3) Database administrators managing and inspecting database structures.

How to use

To use jewei-mssql-mcp-server, you need to install it via PyPI or from the source code. After installation, configure the MCP server in your client application by specifying the database connection details in the configuration file. Finally, start the server using the command ‘python server.py’.

Key features

Key features of jewei-mssql-mcp-server include: 1) Data querying capabilities to execute SQL queries and return result sets; 2) Table structure querying to retrieve information about database table structures; 3) User-friendly interface through standardized MCP protocol; 4) Efficient and reliable database connection management.

Where to use

jewei-mssql-mcp-server can be used in various fields that require interaction with Microsoft SQL Server databases, including software development, data analysis, and database management.

Jewei MSSQL MCP 服务器

项目简介

这是一个基于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 的具体配置格式进行调整。

安装与配置

前提条件

• Python 3.7+
• 访问Microsoft SQL Server的权限
• FastMCP库

安装步骤

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

pip install jewei-mssql-mcp-server

方法二：从源码安装

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. Fork本仓库
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

许可证

[指定许可证类型]

联系方式

如有问题或建议，请联系[联系人信息]。