MCP Demo Server

🚀 MCP 示范服务器

这是一个简单的 Model Context Protocol (MCP) 服务器示例项目，展示了如何使用 Python 构建基本的 MCP 工具，帮助开发者快速上手 MCP 相关开发。

✨ 主要特性

本项目实现了两个简单的 MCP 工具：

• add：一个简单的加法函数，接受两个整数并返回其总和。
• say_hello：一个问候函数，接受名字参数并返回问候语。

📦 安装指南

克隆项目

git clone [repository-url]
cd mcp-demo

创建虚拟环境并安装依赖

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate
pip install mcp[cli]

💻 使用示例

基础用法

要启动 MCP 服务器，请执行：

uv run --with mcp[cli] mcp run server.py

高级用法

在开发模式下测试 MCP 服务器：

mcp dev server.py

这个命令会：

1. 在开发模式下启动服务器。
2. 自动重新载入代码变更。
3. 提供更详细的调试信息。

📚 详细文档

项目结构

mcp-demo/
├── server.py        # MCP 服务器主程序
├── .gitignore      # Git 忽略文件
└── README.md       # 本文件

开发说明

服务器实现了两个基本工具：

1. add(a: int, b: int) -> int

   • 功能：将两个整数相加。
   • 参数：
     • a：第一个整数。
     • b：第二个整数。
   • 返回：两数之和。

2. say_hello(name: str) -> str

   • 功能：生成个性化的问候语。
   • 参数：
     • name：要问候的人名。
   • 返回：包含问候语的字符串。

配置

项目包含 VS Code 配置文件 (.vscode/mcp.json)，可直接在 VS Code 中执行和测试 MCP 服务器。

GitHub Copilot 配置

要在 GitHub Copilot 中使用此 MCP 服务器，请在 VS Code 中进行以下设置：

1. 在项目根目录创建 .vscode 文件夹（如果还没有的话）。

2. 在 .vscode 文件夹中创建 mcp.json 文件，内容如下：

{
    "servers": {
      "Demo": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mcp[cli]",
          "mcp",
          "run",
          "${workspaceFolder}/server.py"
        ]
      }
    }
}

3. 设置完成后，GitHub Copilot 将能够自动连接到您的 MCP 服务器，并使用其提供的工具功能。

⚠️ 重要提示

• 确保已正确安装 uv 套件管理工具。
• ${workspaceFolder} 会自动被替换为您的项目根目录路径。
• 如果使用不同的 Python 环境管理工具，可以适当调整相应的配置。

🔧 技术细节

技术需求

• Python 3.x
• MCP (模型上下文协议) 库
• uv (Python 套件管理工具)