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  # 在 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              # MCP 服务器定义
├── main.py                # 应用程序入口点
├── tests/                 # 自动化测试
│   └── test_server.py     # 服务器测试
├── pyproject.toml         # 项目依赖和元数据
└── README.md              # 本文档

运行测试

pytest

待办事项 (To-Do)

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

添加新工具

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

@mcp.tool()
def minha_ferramenta(parametro1: str, parametro2: int) -> str:
    """我的工具的描述"""
    return f"结果: {parametro1} - {parametro2}"

添加新资源

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

@mcp.resource("meu-recurso/{id}")
def obter_recurso(id: str) -> dict:
    """通过 ID 获取资源信息"""
    return {"id": id, "nome": f"资源 {id}"}