Mcphost MSSQL Easyguide

MCP数据服务

提供方 Mortaza76

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

该MCP服务器实现了本地LLM(如Qwen2.5 7B)与Microsoft SQL Server数据库的安全只读集成,支持通过自然语言查询和分析SQL数据。

一句话选型结论

按资料字段整理

Mcphost MSSQL Easyguide 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

数据库集成Python本地部署自然语言查询本地AISQL分析企业数据安全

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv loca

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mcphost MSSQL Easyguide当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Mortaza76上游标注的维护方 Mortaza76
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.7 KB
来自项目仓库与上游目录的原文,未做删改

用于本地LLM集成的MSSQL MCP服务器

概述

此MCP(模型上下文协议)服务器实现了本地LLM(Qwen2.57B,通过Ollama)和Microsoft SQL server数据库之间的无缝集成。该服务器为您的本地AI模型提供安全、只读的数据库访问,使其能够通过自然语言交互查询和分析您的SQL数据。

先决条件

所需软件

  • Go语言 (必须先安装)
  • 奥拉玛 -本地LLM运行时环境
  • Python 3.10+ -MCP服务器的运行时环境
  • Microsoft SQL Server -目标数据库系统
  • SQL Server的ODBC驱动程序18 -数据库连接

分步安装指南

第一步:安装Go语言

在继续之前,此步骤是强制性的!

  1. 下载Go 来自官方网站:```
    https://go.dev/doc/install

1. **安装Go** 对于您的操作系统:

- **macOS**:下载.pkg安装程序并按照安装向导进行操作
- **视窗**:使用.msi安装程序
- **Linux**:使用tar.gz包或包管理器

1. **验证安装**:```bash
go version

如果安装正确,您应该会看到Go版本号。

步骤2:安装mcphost

安装Go后,运行:```bash
go install github.com/mark3labs/mcphost@latest


这将安装mcphost实用程序,这对于在Ollama上运行MCP服务器至关重要。

### 步骤3:设置Python环境

1. **创建虚拟环境**:```bash
python -m venv loca
  1. 激活虚拟环境:
  • macOS/Linux:```bash
    source loca/bin/activate
- **视窗**:```bash
loca\Scripts\activate
  1. 安装Python依赖项:```bash
    pip install pyodbc python-dotenv mcp

### 步骤4:配置环境变量

创建一个 `.env` 项目目录中的文件,其中包含:```
MSSQL_SERVER=your_server_name
MSSQL_USERNAME=your_username
MSSQL_PASSWORD=your_password
MSSQL_DRIVER=ODBC Driver 18 for SQL Server

步骤5:下载Olama和正确的模型

  1. 安装Ollama 从 奥拉玛

  2. 拉正确的模型 (工具启用版本):```bash
    ollama pull qwen2.5:7b


## 关键:工具集成的模型选择

⚠️ **重要**:在选择Olama车型时 **必须** 选择一个支持工具/函数调用功能的模型。并非所有型号都内置了此功能。

### MCP集成的推荐模型:

- **qwen2.5:7b** (确认工作)
- **美洲驼3.1:8b** (工具启用版本)
- **phi3:中等** (函数调用支持)
- **吉玛书2:2b** (工具已启用)

**为什么这很重要**:MCP服务器依赖于LLM理解和调用特定工具/功能的能力。没有工具集成功能的模型将无法利用此MCP服务器提供的数据库查询功能。

## 运行MCP服务器

### 步骤1:启动MCP服务器

**在VS代码终端(或您首选的IDE)中:**

1. **激活您的虚拟环境** (如果尚未激活):```bash
source loca/bin/activate  # macOS/Linux
# or
loca\Scripts\activate    # Windows
  1. 运行MSSQL服务器脚本:```bash
    python mssql.py

您应该看到: `"Starting MCP server main loop..."` 表示服务器正在运行。

### 第二步:与mcphost建立联系

**在单独的终端窗口(macOS/Linux/Windows)中:**

**重要**:根据您的系统架构调整路径:

- **适用于macOS(ARM64)** -按原样使用:```bash
mcphost -m ollama:qwen2.5 --config "/Users/ameermortaza/Desktop/Ollama/loca.json"
  • 对于Windows -相应地调整路径:```bash
    mcphost -m ollama:qwen2.5 --config "C:\path\to\your\loca.json"

- **对于Linux** -相应地调整路径:```bash
mcphost -m ollama:qwen2.5 --config "/home/username/path/to/loca.json"

关键配置说明

更新 loca.json 文件 对于您的特定系统:```json
{
"mcpServers": {
"mssql": {
"command": "python",
"args": ["/ABSOLUTE/PATH/TO/YOUR/mssql.py"],
"env": {
"VIRTUAL_ENV": "/ABSOLUTE/PATH/TO/YOUR/loca",
"PATH": "/ABSOLUTE/PATH/TO/YOUR/loca/bin:...rest of your PATH..."
}
}
}
}


**用实际的系统路径替换路径!**

## 可用工具

MCP服务器提供了四种主要工具来增强您的本地LLM:

### 1. `list_databases`

- **目的**:发现SQL Server上的所有可用数据库
- **用法**:“显示可用的数据库”
- **输出**:不包括系统数据库的用户数据库列表

### 2. `list_tables`

- **目的**:探索特定数据库中的表
- **参数**: `database` (必填)
- **用法**:“‘Sales’数据库中有哪些表?”
- **输出**:带有计数的架构和表名

### 3. `list_columns`

- **目的**:检查表结构和元数据
- **参数**: `database`, `table` (两者都需要)
- **用法**:“显示'客户'表中的列”
- **输出**:列名、数据类型、可空性和默认值

### 4. `run_query`

- **目的**:执行安全的只读SQL查询
- **参数**: `database`, `sql` (两者都需要)
- **安全**:验证查询以阻止写入操作(INSERT、UPDATE、DELETE等)
- **用法**:“按购买金额获得前10名客户”
- **输出**:带列标题和数据的格式化查询结果

## 安全特性

- **只读访问**:所有写入操作都被明确阻止
- **查询验证**:正则表达式验证可防止危险的SQL命令
- **环境变量**:存储在代码外部的敏感凭据
- **错误处理**:全面的日志记录和错误管理

## 常见问题排查

### 问题1:“未找到命令:mcphost”

**解决方案**:确保Go已正确安装,并且您的GOPATH位于您的PATH中:```bash
export PATH=$PATH:$(go env GOPATH)/bin

问题2:Python模块错误

解决方案:确保您的虚拟环境已激活并安装了依赖项:bash source loca/bin/activate pip install -r requirements.txt # or reinstall dependencies

问题3:Windows/Linux上的路径错误

解决方案:更新中的所有路径 loca.json 为了与您的系统架构相匹配:

  • 窗户: C:\Users\YourName\Desktop\Ollama\mssql.py
  • Linux: /home/yourname/Desktop/Ollama/mssql.py

问题4:模型无法识别工具

解决方案:确保您使用的是启用工具的模型,如 qwen2.5:7b

人工智能中MCP的未来

当前影响:

  • 民主化:使本地LLM能够安全地访问企业数据
  • 隐私:数据永远不会离开您的基础设施
  • 降低成本:消除了基于云的人工智能服务的API成本
  • 定制:与现有系统的定制集成

未来潜力:

  1. 企业采用MCP将成为人工智能集成的标准
  2. 多模态扩展:从数据库到文件系统、API和物联网
  3. 标准化:全行业人工智能工具调用协议
  4. 专用服务器:医疗保健、金融等领域的特定MCP。
  5. 联邦学习:MCP实现了无需数据共享的协作人工智能

需要帮助?

如果您在设置或操作过程中遇到任何问题,请随时联系我们寻求帮助:

联系: 网站: Mortaza76.github.io

结论

这个MSSQL MCP服务器将您的本地Qwen2.5 LLM从通用聊天机器人转换为强大的数据分析工具。通过仔细遵循这些步骤并确保为您的特定操作系统进行正确配置,您将创建一个能够真正理解并与您的组织数据交互的AI助手。

记住关键步骤:

  1. 先安装Go
  2. 通过Go安装mcphost
  3. 设置Python虚拟环境
  4. 在一个终端中运行mssql.py
  5. 在另一个终端中连接mcphost
  6. 为您的特定操作系统调整路径

MCP协议代表了人工智能集成的未来——安全、可定制和企业就绪。

如果你想使用Linux AMD-64架构在虚拟机上部署它
太好了!🙌 既然你的VM中已经有了整个管道,让我为你起草一份全面的、循序渐进的文档,解释你所做的一切——从设置Python到创建虚拟环境、安装依赖项、配置Ollama+MCP,以及运行查询。

⸻

📝 在Ubuntu虚拟机上使用Ollama+MSSQL设置MCP

本文档解释了如何在Ubuntu 20.04 VM中设置本地开发环境,以运行连接到SQL server的Python MCP服务器(mssql.py),并使用MCPHost将其与Ollama模型(如Qwen2.5或Llama3.1)集成。

⸻

  1. 安装Python 3.10.18和虚拟环境

Ubuntu 20.04附带了Python 3.8,对于现代库来说太旧了。您从源代码构建了Python 3.10.18,然后为您的项目创建了一个专用的虚拟环境。

验证Python版本

python3--版本
python3.10--版本

在桌面中创建一个名为“loca”的venv

cd~/桌面
python3.10-m虚拟局域网

激活venv

来源~/桌面/loca/bin/activate

激活后,您的提示显示(loca)。

⸻

  1. 安装所需的Python库

在虚拟环境中,安装mssql.py所需的所有库:

pip安装mcp-pyodbc-python-dotenv

mcp中已经包含了其他依赖项:
•starlette、uvicorn、httpx等。

检查已安装的软件包:

pip列表

⸻

  1. 安装SQL Server ODBC驱动程序

由于Python脚本使用pyodbc,您需要微软的ODBC驱动程序:

更新源
sudo apt-get安装-y msodbcsql18 unixodbc开发

这确保pyodbc可以从Linux连接到SQL Server。

⸻

  1. 为数据库凭据创建.env文件

您的脚本从.env加载数据库凭据。在~/Desktop/.env中创建它:

MSSQL_SERVER=192.168.1.16
MSSQL_DATABASE=SkyUpAuth
MSSQL_USERNAME=admin
MSSQL_PASSWORD=Prosoft@bel21
MSSQL_DRIVER=SQL Server的ODBC驱动程序18

⸻

  1. 创建mssql.py

此文件使用MCP.server实现MSSQL的MCP服务器。您将其放置在:

/主页/devops/桌面/mssql.py

它
•Loads.env
•使用pyodbc连接到SQL Server
•定义MCP工具:
•列表_数据库
•列表表
•列表_列
•run_query

手动运行它进行测试:

(loca)python mssql.py

您应该看到以下日志:

加载环境变量并初始化MCP服务器。..
正在启动MCP服务器主循环。..

⸻

  1. 安装Olama和模型

您从官方脚本安装了Ollama:

curl-fsSLhttps://ollama.com/install.sh|sh

然后拉取模型:

奥拉玛拉qwen2.5:7b
Ollama Pull Callama 3.1:8b

检查已安装的型号:

奥拉玛列表

⸻

  1. 安装Go和MCPHost

MCPHost是用Go编写的。要安装:

下载Go

wgethttps://go.dev/dl/go1.25.1.linux-amd64.tar.gz
sudo rm-rf/usr/local/go
sudo tar-C/usr/local-xzf go1.25.1.linux-amd64.tar.gz

添加到PATH

echo'导出路径=$PATH:/usr/local/go/bin:$HOME/go/bin'>~/.bashrc
源码~/.bashrc

验证

go版本

安装mcphost:

去安装github。com/mark3labs/mcphost@latest

检查:

哪种mcphost
mcphost-版本

⸻

  1. 创建loca.json配置

此命令将告诉MCPHost如何启动MSSQL MCP服务器:

{
“mcpServers”:{
“mssql”:{
“command”:“python”,
“args”:[“/home/develops/Desktop/mssql.py”],
“env”:{
“VIRTUAL_ENV”:“/home/deops/桌面/loca”,
“路径”:“/home/devops/Destop/loca/bin:/usr/local/sbin:/usr/sbin:usr/bin:/bin:usr/local/go/bin:/home/depops/go/bin”
}
}
}
}

⸻

  1. 使用Ollama+MSSQL运行MCPHost

现在,您可以启动整个系统:

mcphost-m ollama:qwen2.5--配置“/home/develops/Desktop/loca.json”

您将看到:

加载型号:olama(qwen2.5)
从MCP服务器加载了4个工具

您现在可以与Qwen2.5聊天,它可以访问MSSQL.py中定义的MSSQL工具。

⸻

🔹 工作流程概述
1.Python 3.10.18 venv(loca)→ 运行mssql.py MCP服务器。
2..env文件→ 存储MSSQL连接凭据。
3.pyodbc+ODBC驱动程序→ 让Python与SQL Server对话。
4.奥利玛→ 运行本地LLM(Qwen2.5,Llama3.1)。
5.Go+MCPHost→ 将LLM与MCP服务器连接起来。
6.loca.json→ 告诉MCPHost如何启动MCP服务器。
7.运行mcphost→ 连接LLM+MCP服务器+数据库。

⸻

⚡ 此时,您有一个完全正常工作的管道:
当地法学硕士(Qwen/Llama)↔ MCP主机↔ MSSQL通过Python服务器

⸻

如有任何疑问,请通过我的网站Mortaza76/github.io与我联系。
确保您有一个.env文件,其中包含您登录MSSQL数据库服务器的所有凭据。
我注意到,由于所使用的库和下载的模块的支持,python 3.10+最适合这个项目。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Mcphost MSSQL Easyguide 怎么安装?

在客户端按下面的安装命令接入:python -m venv loca。装完在客户端配置里引用同一个包或端点。

Mcphost MSSQL Easyguide 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Mcphost MSSQL Easyguide 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mcphost MSSQL Easyguide 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Mcphost MSSQL Easyguide 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 数据库集成、本地AI、Python、数据分析。具体工具清单以官方文档为准。

Mcphost MSSQL Easyguide 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Mcphost MSSQL Easyguide 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。