MySQL MCP Server v2

MySQL MCP Server v2

此 MCP（Message Control Protocol）服务器通过 MySQL 数据库提供用于管理和查询部门预算信息的接口。

特性

• 安全连接到 MySQL 数据库
• 管理部门预算
• 按部门代码查询
• 按部门名称搜索
• 记录预算申请
• 强大的错误和连接处理机制

要求

• Python 3.6 或更高版本
• MySQL Server（XAMPP 或类似软件）
• 所需的 Python 包：
  • mcp
  • mysql-connector-python

安装

1. 克隆仓库
2. 安装依赖项：

pip install mcp mysql-connector-python

配置

服务器默认使用以下参数连接到 MySQL 数据库：

db_config = {
    'host': 'localhost',
    'port': 3306,
    'user': 'reporte',
    'password': 'reporte',
    'database': '_REPORTE',
    'raise_on_warnings': True
}

根据你的数据库配置调整这些参数。

功能

1. 查询完整状态

get_estado_completo(codigo: int)

按部门代码返回部门的完整信息，包括：

• 代码
• 名称
• 初始预算
• 申请金额
• 可用余额
• 已支付金额

2. 记录申请

registrar_solicitud(codigo: int, monto: float)

为部门记录新的预算申请：

• 更新申请金额
• 重新计算可用余额
• 安全地处理事务

3. 按名称搜索

buscar_por_nombre(nombre: str)

按名称搜索部门：

• 部分匹配（使用 LIKE）
• 返回多个结果
• 包含每个找到的部门的完整信息

测试

项目包含用于验证功能的测试脚本：

• test_buscar_nombre.py：测试按名称搜索功能
• 运行测试：

python test_buscar_nombre.py

错误处理

服务器实现了强大的错误处理机制：

• 数据库连接错误
• 查询错误
• 数据验证
• 事务出错时自动回滚

数据库结构

主表 departamentos 包含以下字段：

• codigo（int）：部门的唯一标识符
• nombre（varchar）：部门名称
• inicial（decimal）：初始预算
• solicitado（decimal）：申请金额
• saldo（decimal）：可用余额
• pagado（decimal）：已支付金额

运行

启动服务器：

python mysql_mcp_server_v2.py

安全说明

• 数据库凭据以硬编码形式写在代码中。在生产环境中，建议使用环境变量或安全的配置文件。
• 使用上下文管理器模式安全地管理连接。
• 使用适当的 commit/rollback 管理事务。

贡献

1. Fork 仓库
2. 为你的功能创建分支（git checkout -b feature/AmazingFeature）
3. Commit 你的更改（git commit -m 'Add some AmazingFeature'）
4. Push 到分支（git push origin feature/AmazingFeature）
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。