mcp-server-demo-clientedb

🚀 MCP 服务器演示 - 客户端数据库

这是一个示例服务器，展示了如何将 MCP 与 SQLite 集成，以实现对客户的有效管理。通过该服务器，可轻松进行客户信息的统计、搜索等操作，为客户管理提供便利。

🚀 快速开始

环境准备

1. 创建并激活虚拟环境：

# 创建虚拟环境
python3 -m venv .venv

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

2. 安装依赖项：

pip install -r requirements.txt # 在虚拟环境中安装

python3.12 -m pip install -r requirements.txt --break-system-packages  # 在物理机上安装

3. 生成示例数据：

python generate_sample_data.py

4. 启动 MCP 服务器：

mcp dev server.py # 使用mcp inspector
mcp install server.py --name "ClientesMCP" # 安装到Claude桌面

python mcp_server.py # 通过SSE协议使用

关闭虚拟环境

完成操作后，可使用以下命令关闭虚拟环境：

deactivate

✨ 主要特性

该服务器提供了以下实用功能：

1. contar_clientes(): 返回已注册的客户总数。
2. buscar_cliente_por_nome(nome): 根据姓名搜索客户（支持部分匹配）。
3. buscar_clientes_por_bairro(bairro): 搜索特定社区的所有客户。

📚 详细文档

数据库结构

clientes 表包含以下字段： | 字段 | 类型 | 详情 | | ---- | ---- | ---- | | id | INTEGER | 主键 | | nome | TEXT | 客户姓名 | | email | TEXT | 客户邮箱 | | telefone | TEXT | 客户电话 | | bairro | TEXT | 客户所在社区 | | endereco | TEXT | 客户地址 |

示例数据中的社区

示例数据中包含以下社区的客户：

• 中心区
• 美国花园
• 新村
• 美丽 vista