MCP服务器模板

一个用于创建基于Python和stdio传输的Model Context Protocol (MCP)服务器的模板仓库,支持VS Code集成开发。

  • by HappyPathway
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 happypathway/gcs-mcp-server

使用说明

Python MCP服务器模板

一个模板存储库,用于使用Python和stdio传输创建模型上下文协议(MCP)服务器。

概述

此模板为构建与VS Code集成的MCP服务器提供了标准化设置。它使用:

  • Python与官方MCP服务器库
  • 通信标准输入/输出(stdio)
  • VS代码集成,实现无缝开发

特性

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

入门指南

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

项目结构

.
├── 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  # or `venv\Scripts\activate` on Windows
    pip install -r requirements.txt
    
  2. 配置VS代码:

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

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

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 提交拉取请求

许可证

[您选择的许可证]