mcpField
M
MCP Server Demo - ClienteDB

MCP Server Demo - ClienteDB

本地服务
github.com/amauryeuzebio开发工具381 周前更新
代码仓库

关于 MCP Server Demo - ClienteDB

MCP Server Demo - ClienteDB 是一个将 SQLite 客户数据用于查询的示例 MCP 服务，展示客户计数以及按姓名和街区搜索记录。

主要功能

  1. 01统计已登记客户数
  2. 02按姓名部分匹配客户
  3. 03按街区查找客户

适用场景

  1. 01查看客户记录总数
  2. 02使用姓名片段查找客户
  3. 03列出指定街区的客户

MCP 相关

它通过 MCP 工具提供 SQLite 客户数据查询，包括客户计数以及按姓名或街区搜索。

#mcp-server#sqlite#client-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP 服务演示 - ClienteDB

这是一个 MCP 服务示例，演示如何集成 SQLite 来管理客户。

功能

该服务提供以下工具：

  1. contar_clientes(): 返回已登记客户的总数
  2. buscar_cliente_por_nome(nome): 按姓名搜索客户（部分匹配）
  3. buscar_clientes_por_bairro(bairro): 搜索指定街区的所有客户

使用方法

  1. 创建并激活虚拟环境：
# Criar ambiente virtual
python3 -m venv .venv

# Ativar ambiente virtual
# No Windows:
.venv\Scripts\activate
# No macOS/Linux:
source .venv/bin/activate
  1. 安装依赖：
pip install -r requirements.txt # instalar no ambiente virtual

python3.12 -m pip install -r requirements.txt --break-system-packages  # Instalar máquina física
  1. 生成示例数据：
python generate_sample_data.py
  1. 启动 MCP 服务：
mcp dev server.py # para usar mcp inspector
mcp install server.py --name "ClientesMCP" # instala o mcp no claude desktop

python mcp_server.py # para usar pelo protocolo sse

完成后，停用虚拟环境：

deactivate

数据库结构

clientes 表包含以下字段：

  • id (INTEGER, PRIMARY KEY)
  • nome (TEXT)
  • email (TEXT)
  • telefone (TEXT)
  • bairro (TEXT)
  • endereco (TEXT)

可用街区

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

  • Centro
  • Jardim América
  • Vila Nova
  • Bela Vista

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。