Python MCP 服务器模板

这是一个使用带有 stdio 传输的 Python 创建模型上下文协议 (MCP) 服务器的模板仓库。

概述

此模板提供了一个标准化的设置，用于构建与 VS Code 集成的 MCP 服务器。它使用了：

• 带有官方 MCP 服务器库的 Python
• 标准输入/输出（stdio）进行通信
• 无缝开发的 VS Code 集成

特性

• 使用装饰器实现的示例 MCP 工具
• 支持 VS Code 开发环境
• 简单可靠的基于 stdio 的本地开发传输
• 使用 VS Code 的 Python 调试器轻松调试

快速开始

1. 使用此模板仓库创建您的新 MCP 服务器项目
2. 创建并激活一个 Python 虚拟环境
3. 从 requirements.txt 安装依赖
4. 在 Python 代码中自定义 MCP 工具
5. 使用 VS Code 进行本地测试

项目结构

.
├── src/                    # Python source code
│   └── server.py          # MCP server implementation
├── .vscode/               # VS Code configuration
└── README.md              # Project documentation

自定义

要实现您自己的 MCP 服务器：

1. 修改 Python 代码，使用 @tool 装饰器添加您的自定义工具
2. 如果需要额外的依赖项，请更新 requirements.txt
3. 配置您的 VS Code 工作区设置

开发

1. 设置 Python 虚拟环境：

   python -m venv venv
   source venv/bin/activate  # 或者在 Windows 上使用 `venv\Scripts\activate`
   pip install -r requirements.txt
   

2. 配置 VS Code：

   • 创建 .vscode/mcp.json 文件，配置 stdio
   • 在 VS Code 中设置 Python 解释器
   • 使用集成终端运行命令
   • 使用 VS Code 的 Python 调试器调试您的 MCP 服务器

3. 测试您的 MCP 服务器：

   • 使用 VS Code 内置的 MCP 服务器测试功能
   • 通过断点和 VS Code 的调试控制台进行调试
   • 在输出面板中监控 stdio 通信

贡献

1. 叉取仓库
2. 创建功能分支
3. 提交拉取请求

许可证

[您选择的许可证]