Demonstração do Servidor MCP

MCP 服务演示

概述

本项目演示了 MCP（Mission Control Protocol）服务的实现。它提供了一个简单高效的平台，可通过 MCP 协议创建和管理基于资源和工具的 API。

此代码基于 MCP Python SDK，这是 MCP 协议的官方 Python 实现。

功能

• 通过 Python 装饰器快速创建工具
• 使用 URL 模式公开动态资源
• 轻松集成现有系统
• 为服务开发提供直观的 API

先决条件

• Python 3.12 或更高版本
• pip（Python 包管理器）

安装

1. 克隆仓库：

git clone https://github.com/seu-usuario/mcp-server-demo.git
cd mcp-server-demo

2. 创建虚拟环境（可选，但建议创建）：

python -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate

3. 安装依赖项：

pip install -e .

用法

运行服务

python -m server

服务将在本地运行，并提供 server.py 文件中定义的端点。

基本用法示例

使用加法工具

curl -X POST "http://localhost:8000/tools/add" -H "Content-Type: application/json" -d '{"a": 5, "b": 10}'

获取个性化问候语

curl -X GET "http://localhost:8000/resources/greeting/Maria"

开发

项目结构

mcp-server-demo/
├── server.py              # Definição do servidor MCP
├── main.py                # Ponto de entrada do aplicativo
├── tests/                 # Testes automatizados
│   └── test_server.py     # Testes para o servidor
├── pyproject.toml         # Dependências e metadados do projeto
└── README.md              # Esta documentação

运行测试

pytest

待办事项（To-Do）

• 测试中的 Bug：自动化测试中存在一个已知问题，需要修复。与客户端集成相关的测试可能会失败，原因是测试客户端的配置存在问题。
• 实现更多测试，以覆盖更多用例
• 改进 API 文档

添加新工具

要向 MCP 服务添加新工具，请使用装饰器 @mcp.tool()：

@mcp.tool()
def minha_ferramenta(parametro1: str, parametro2: int) -> str:
    """Descrição da minha ferramenta"""
    return f"Resultado: {parametro1} - {parametro2}"

添加新资源

要添加新资源，请使用装饰器 @mcp.resource()：

@mcp.resource("meu-recurso/{id}")
def obter_recurso(id: str) -> dict:
    """Obtém informações do recurso pelo ID"""
    return {"id": id, "nome": f"Recurso {id}"}