MCP App Transporte

🚀 MCP传输应用程序

📋 概览

Python MCP（模型上下文协议） 与Java Spring Boot应用程序集成。

4 基本功能：

1. 🔍 寻找客户 列出所有注册客户
2. 📦 搜索订单 - 列出所有已注册的订单
3. ➕ 地籍客户 向系统添加新客户端
4. 📝 Cadastrar Pedido 在系统中创建新请求

______________________________________________________________________

🛠️ 技术

• Python 3.12 主要语言
• MCP框架 -模型上下文协议com装饰器 @mcp.tool
• httpx - 异步 HTTP 客户端
• 皮丹提克 - 数据验证
• Java春季启动 -API后端（门户8080）

______________________________________________________________________

清洁结构

mcp-app-transsport/
├── src/
│   ├── models/
│   │   ├── usuario.py          # Modelo Cliente simplificado
│   │   └── order.py            # Modelo Pedido simplificado
│   ├── services/
│   │   └── api_service.py      # Serviço API Java (4 métodos)
│   ├── tools/
│   │   └── transport_tools.py  # Tools MCP (não usado no servidor moderno)
│   └── server_modern.py        # 🎯 SERVIDOR PRINCIPAL (usar este!)
├── scripts/
│   ├── run.py                  # Script principal menu interativo
│   ├── tests/
│   │   └── test_all_functions.py  # Testes automatizados
│   └── utils/
│       └── diagnostic.py       # Diagnóstico da API Java
├── requirements.txt            # Dependências Python
└── README.md                   # Esta documentação

______________________________________________________________________

如何使用

1. 安装

# Clonar repositório
git clone https://github.com/RenanStMeira/MCP-app-transporte.git
cd MCP-app-transporte

# Criar ambiente virtual
python -m venv venv
source venv/Scripts/activate  # Windows Git Bash

# Instalar dependências
pip install -r requirements.txt

2. 验证Java API

请确保您的 Java 应用程序正在端口 8080 上运行：

curl http://localhost:8080/api/usuario

3. 测试功能

# Menu interativo (RECOMENDADO)
python scripts/run.py

# Ou testar tudo automaticamente
python scripts/tests/test_all_functions.py

# Ou diagnóstico da API Java
python scripts/utils/diagnostic.py

______________________________________________________________________

🤖 与 GitHub Copilot 集成

VS Code 中的设置

添加到您的 settings.json:

{
    "mcp.servers": {
        "transport-app": {
            "command": "d:\\Studies\\MCP\\mcp-app-transsport\\venv\\Scripts\\python.exe",
            "args": ["d:\\Studies\\MCP\\mcp-app-transsport\\src\\server_modern.py"],
            "cwd": "d:\\Studies\\MCP\\mcp-app-transsport",
            "env": {
                "JAVA_API_URL": "http://localhost:8080/api"
            }
        }
    }
}

如何使用

设置后， 重新输入VS代码 问一些自然的问题：

• *“我们注册了多少客户？”*
• *“列出所有请求”*
• *“注册一个名叫João Silva的客户”*
• *“创建住宅变更请求”*

______________________________________________________________________

🎯 详细功能

1。🔍 寻找客户

@mcp.tool()
async def buscar_clientes() -> str:
    """Lista todos os clientes cadastrados"""

• 端点: GET /api/usuario
• 返回客户ID、姓名、电子邮件和电话列表

2 。📦 搜索订单

@mcp.tool()
async def buscar_pedidos() -> str:
    """Lista todos os pedidos cadastrados"""

• 端点: GET /api/pedido
• 返回列出订单ID、描述、价值、客户和状态

3。➕ 地籍客户

@mcp.tool()
async def cadastrar_cliente(nome: str, email: str, senha: str, telefone: Optional[str] = None) -> str:
    """Cadastra novo cliente"""

• 端点: POST /api/usuario
• 雷克尔姓名、电子邮件、密码（可选电话）

4.📝 Cadastrar Pedido

@mcp.tool()
async def cadastrar_pedido(descricao: str, valor: Optional[float] = None, cliente_id: Optional[int] = None) -> str:
    """Cadastra novo pedido"""

• 端点: POST /api/pedido
• 雷克尔描述（可选值和客户ID）

______________________________________________________________________

🧪 睾丸

# Ativar ambiente
source venv/Scripts/activate

# Testar tudo automaticamente
python scripts/tests/test_all_functions.py

# Menu interativo para testar individualmente
python scripts/run.py

# Diagnóstico da API Java
python scripts/utils/diagnostic.py

______________________________________________________________________

🔧 API端点Java Esperados

用户/客户

• GET /api/usuario 列出所有用户
• POST /api/usuario - 注册新用户

订单

• GET /api/pedido 列出所有订单
• POST /api/pedido - 注册新订单

数据格式

用户 ：

{
    "idUsuario": 1,
    "nome": "João Silva", 
    "email": "joao@email.com",
    "telefone": "(11) 99999-9999"
}

请求 ：

{
    "idPedido": 1,
    "descricao": "Transporte de móveis",
    "valor": 150.00,
    "idUsuario": 1,
    "status": "PENDENTE"
}

______________________________________________________________________

🔍 故障排除

Java API 连接错误

# Verificar se API está rodando
curl http://localhost:8080/api/usuario

# Diagnóstico completo
python scripts/utils/diagnostic.py

问题a没有MCP/GGitHub副本

1. 验证日志: View > Output > MCP
2. 再保险VS代码 设置 settings.json
3. 测试服务器: python src/server_modern.py

Python 依赖错误

# Reinstalar dependências
pip install --upgrade -r requirements.txt

# Verificar ambiente
which python  # deve apontar para venv

______________________________________________________________________

📞 支撑

• GitHub: RenanStMeira/MCP 应用程序传输
• MCP 文档: mcp.dev

______________________________________________________________________

🎉 状态

✅ 清洁和现代的设计

• ✅ 简化结构
• ✅ MCP现代装饰师(@mcp.tool)
• ✅ 4 基本功能
• ✅ 组织脚本
• ✅ 文档已更新
• ✅ GitHub Copilot 集成

干净，专注和专业的代码！ （2）🚀