MCP Server 5s8

🚀 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

示例截圖