Neoforge MCP Server

🚀 終端命令運行器 MCP 服務器

終端命令運行器 MCP 服務器是一個功能強大的模型控制協議（MCP）服務器，它藉助 RESTful API 接口，為 AI 助手賦予了終端命令執行和文件系統管理的能力。

🚀 快速開始

先決條件

• Python 3.13+
• uv 包管理器（推薦）

安裝

1. 克隆倉庫：

git clone https://github.com/neoforge-dev/neoforge-mcp-server.git
cd python-server-mcp

2. 創建虛擬環境並安裝依賴項：

uv venv
source .venv/bin/activate  # Windows 環境下：.venv\Scripts\activate
uv pip install -e .

3. 啟動 MCP 服務器：

python server.py

服務器將在 http://0.0.0.0:8000 上運行。

✨ 主要特性

終端管理

• 執行帶有可配置超時的命令
• 管理後臺長-running 進程
• 從活動命令會話獲取輸出
• 列出所有活動會話和系統進程
• 終止或殺死進程
• 命令黑名單功能（安全）

文件系統操作

• 讀取和寫入文件
• 創建目錄
• 列出目錄內容
• 移動/重命名文件
• 使用 glob 模式搜索文件
• 獲取詳細文件信息

高級功能

• 精確文本編輯（包括搜索和替換）
• 系統信息檢索
• 數學表達式計算

🧪 測試

該項目包含全面的測試套件以驗證功能：

# 安裝測試依賴項
uv pip install -r requirements.txt

# 運行所有測試
./run_tests.py

# 生成覆蓋率報告運行測試
./run_tests.py --coverage

# 詳細輸出運行測試
./run_tests.py --verbose

# 運行特定測試文件
./run_tests.py --test tests/test_command_execution.py

測試套件覆蓋以下內容：

• 命令執行和進程管理
• 文件系統操作
• 系統實用工具
• 安全功能

🔧 技術細節

通過將 MCP 服務添加到 ~/.cursor/mcp.json 文件來配置 Cursor：

{
  "mcpServers": {
    "NeoMCP": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/python-server-mcp/server.py"
      ]
    }
  }
}

📚 詳細文檔

終端工具

• execute_command：帶有超時配置的命令執行
• read_output：獲取運行進程的輸出
• force_terminate：停止正在運行的命令
• list_sessions：顯示所有活動命令會話
• list_processes：查看所有系統進程
• kill_process：按 PID 殺死進程
• block_command：將命令添加到黑名單
• unblock_command：從黑名單中移除命令

文件系統工具

• read_file：讀取文件內容
• write_file：向文件寫入數據
• create_directory：創建新目錄
• list_directory：列出目錄內容
• move_file：移動或重命名文件
• 獲取詳細文件信息

高級工具

• 精確文本編輯（包括搜索和替換）
• 系統信息檢索
• 數學表達式計算

🤝 貢獻指南

歡迎貢獻！請參考 CONTRIBUTING.md 瞭解如何參與。

📄 許可證

本項目受 LICENSE 保護。