🚀 MCP 服务器

MCP 服务器为 AI 驱动的命令执行与工具管理提供了一个灵活的框架，能有效提升相关操作的效率与便捷性。

🚀 快速开始

MCP 服务器提供了强大的功能，要使用它，你需要完成安装和环境配置。下面将为你详细介绍相关步骤。

✨ 主要特性

• 命令执行工具：可用于执行和管理 shell 命令。
• 异步命令执行：支持长轮询 (Long Polling)、服务器发送事件 (SSE) 和 websocket 通信。
• 文件处理工具：涵盖文件上传、下载和转换等功能。

📦 安装指南

手动安装

# 使用 uv（推荐）：
uv pip install -e ./mcp_core
uv pip install -e ./mcp_tools
uv pip install -e .

# 或使用 pip：
pip install -e ./mcp_core
pip install -e ./mcp_tools
pip install -e .

此操作会将所有本地包安装为开发模式，便于你在更改代码时使用这些包。

📚 详细文档

项目结构

MCP 项目由以下几个部分构成：

• mcp_core/：核心类型和适配器
  • mcp_core/tests/：核心类型和功能的测试
• mcp_tools/：实用工具和实现
  • mcp_tools/command_executor/：命令执行工具
  • mcp_tools/tests/：实用工具的测试
• server/：MCP 服务器的主要实现
  • server/tests/：特定于服务器的功能测试
  • server/.private/：私有配置目录（被 git 忽略）
• scripts/：项目管理的实用脚本
• assets/：项目资产和文档中的图片
• config/：集中式的配置模块
  • config/templates/：配置模板

环境配置

MCP 项目采用基于 .env 文件的集中式环境配置系统，确保不同组件配置的一致性。

设置你的环境

1. 复制模板文件以创建 .env 文件：

   cp config/templates/env.template .env
   

2. 编辑 .env 文件以配置环境设置：

   # 仓库信息
   GIT_ROOT=/path/to/git/repo
   WORKSPACE_FOLDER=/path/to/workspace
   PROJECT_NAME=mcp_project
   
   # Azure 仓库配置
   AZREPO_ORG=your_organization_name
   AZREPO_PROJECT=your_project_name
   

3. 将环境变量添加到终端或 IDE：

   export $(cat .env | grep -vE "^\s*#" | cut -d= -f1)
   

在 VSCode/Cursor 中配置 MCP 服务器

推荐通过 .env 文件配置 MCP 服务器，你也可以在编辑器配置中覆盖设置：

{
    "mcpServers": {
      "mymcp": {
        "command": "python",
        "args": ["server/main.py"],
        "env": {
          "GIT_ROOT": "${workspaceFolder}"
        }
      },
      "mymcp-sse" : {
        "url": "http://0.0.0.0:8000/sse"
      }
    }
}

测试运行

你可以手动使用 pytest 运行测试：

# 运行所有测试
python -m pytest

# 运行特定组件的测试
python -m pytest mcp_core/tests
python -m pytest mcp_tools/tests
python -m pytest server/tests

示例截图