mcp-examples

🚀 MCP示例项目

本项目展示了一个模型上下文协议（MCP）的服务器和客户端设置，包含在Docker容器中运行服务器所需的工具和配置。

📦 安装指南

构建Docker镜像

从项目根目录运行以下命令：

docker build -t mcp-example-stdio-server:latest .

这将创建一个名为 mcp-example-stdio-server:latest 的Docker镜像，其中包含MCP服务器。

独立运行服务器

可以直接运行以下命令启动服务器：

docker run --rm -i mcp-example-stdio-server:latest

服务器将启动并监听MCP标准输入输出请求。

💻 使用示例

mcp.json 配置

.vscode/mcp.json 文件用于配置在开发环境（如VS Code）中如何启动MCP服务器：

{
  "servers": {
    "example-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-example-stdio-server:latest"
      ]
    }
  },
  "inputs": []
}

• type：stdio 表示服务器通过标准输入输出进行通信。
• command：用于启动服务器的命令（docker）。
• args：运行带有已构建镜像的Docker容器的参数。

这种设置允许开发工具在容器化环境中自动启动MCP服务器。

📚 详细文档

项目结构

.
├── Dockerfile                # MCP服务器的Docker构建指令
├── pyproject.toml            # Python项目配置
├── uv.lock                   # 依赖项的锁文件
├── README.md                 # 项目文档
├── client/                   # 客户端代码（如果有）
└── servers/                  # MCP服务器实现
    ├── __init__.py
    ├── main.py               # 服务器的主入口点
    └── tools/                # 额外的服务器工具
        ├── __init__.py
        ├── calendar.py       # 日历工具实现
        ├── task_manager.py   # 任务管理器工具实现
        └── weather.py        # 天气工具实现

🔧 技术细节

• 确保系统上已安装并运行Docker。
• 在对服务器代码进行更改后，根据需要通过重新构建镜像来更新Docker镜像。
• servers/tools/ 目录包含模块化的工具实现，可以根据需要进行扩展。