Files
lzwcai-mcp-server-package/lzwcai_mcpskills_analyzeWorkOrder
yuanzhipeng 053d98dffd feat(analyzeWorkOrder): 重构工单分析MCP技能模块并更新业务查询配置
- 将项目名称从 lzwcai-mcp-sqlexecutor 重命名为 lzwcai-mcpskills-analyzeWorkOrder
- 更新 README.md 中的安装命令、使用说明和配置示例
- 本地化业务查询名称,将中文业务名称改为英文,如"查询列表"改为"QueryList"
- 优化SQL模板,移除中文列别名,使用英文字段名
- 新增销售订单相关查询功能,包括订单列表、订单详情、交付风险预测
- 添加部门人效产值损耗三维仪表盘查询
- 更新包的初始化信息和版本号
2026-01-07 22:05:44 +08:00
..

lzwcai-mcpskills-analyzeWorkOrder

一个基于 MCP (Model Context Protocol) 的 SQL 查询执行服务器,支持从 JSON 配置文件动态生成查询工具。

功能特性

  • 🚀 动态工具生成:从 businessQueries.json 自动生成 MCP 工具
  • 🔧 灵活配置:支持自定义业务查询和参数验证
  • 📝 完整日志:详细的操作日志记录
  • 🌐 中文支持:工具名称自动转换为拼音

安装

使用 pip 安装

pip install lzwcai-mcpskills-analyzeWorkOrder

从源码安装

git clone <repository-url>
cd lzwcai_mcp_sqlexecutor
pip install -e .

使用 uv 安装(推荐)

uv pip install lzwcai-mcpskills-analyzeWorkOrder

使用方法

命令行启动

安装后,可以直接通过命令启动:

lzwcai-mcpskills-analyzeWorkOrder

作为 Python 模块运行

python -m lzwcai_mcp_sqlexecutor.main

配置到 MCP 客户端

在你的 MCP 客户端配置文件中添加:

{
  "mcpServers": {
    "lzwcai-sqlexecutor": {
      "command": "lzwcai-mcpskills-analyzeWorkOrder"
    }
  }
}

配置说明

businessQueries.json

businessQueries.json 中定义你的业务查询:

[
  {
    "id": "query-001",
    "businessName": "用户订单查询",
    "businessDescription": "根据用户ID查询订单信息",
    "sqlTemplate": "SELECT * FROM orders WHERE user_id = {{userId}}",
    "parameters": {
      "type": "object",
      "required": ["userId"],
      "properties": {
        "userId": {
          "type": "integer",
          "description": "用户的唯一标识符",
          "examples": [10086]
        }
      }
    }
  }
]

开发

依赖项

  • Python >= 3.13
  • httpx >= 0.28.1
  • mcp[cli] >= 1.10.1
  • pypinyin >= 0.53.0

本地开发

# 克隆仓库
git clone <repository-url>
cd lzwcai_mcp_sqlexecutor

# 安装开发依赖
pip install -e .

# 运行服务器
python -m lzwcai_mcp_sqlexecutor.main

构建与发布

使用 build 构建

pip install build
python -m build

发布到 PyPI

pip install twine
twine upload dist/*

许可证

MIT License

作者

lzwcai