NATE-MCP-SERVER v4.0.0

NATE-MCP-SERVER 是一個基於 Model Context Protocol (MCP) 的強力工具伺服器，旨在賦予大語言模型（如 Claude Desktop）安全地操作本地系統、執行代碼、搜尋網路與整合第三方服務的能力。

✨ 核心功能

• 💻 多語言執行: 支援 Python 代碼、Shell 指令與 MySQL 數據庫操作。
• 📁 進階檔案操作: 讀寫檔案、精準行替換，以及獨家的「區塊簽名替換」功能（大幅提高代碼修改準確度）。
• 🌐 網路增強: 整合 Google 搜尋、网页抓取 (Ollama Web) 與全功能瀏覽器自動化 (Playwright)。
• 📧 服務整合: Gmail 郵件管理、TMDB 電影資料查詢、圖片 AI 辨識。
• 🛡️ 安全防護: 內建黑名單過濾機制與彈性的 API Key 權限分級管理。

🚀 快速開始

1. 環境需求

• Python 3.10+
• Docker & Docker Compose (推薦方式)

2. 使用 Docker 部署 (推薦)

1. 準備配置:
   • 複製 .env.example 並重新命名為 .env，填入必要的 API Key。
   • 複製 docker-compose.example.yaml 並重新命名為 docker-compose.yaml。
2. 路徑調整: 如果是在 NAS 等特殊掛載路徑下執行，請確保 docker-compose.yaml 中的 volumes 物理路徑正確。
3. 啟動服務:

   # Docker Compose V2 (Docker 內建 plugin)
   docker compose up -d
   
   # 或 Docker Compose V1 (獨立安裝版本)
   docker-compose up -d
   

   ⚠️ 注意: 不同安裝方式的 Docker Compose 有不同的命令格式：

   • V2 Plugin: 使用 docker compose（空格）
   • V1 Standalone: 使用 docker-compose（底線）

   可用 docker compose version 或 docker-compose --version 檢查你的版本。

3. 配置 Claude Desktop

修改你的 config.json (通常位於 %AppData%\Cloud\config.json 或 ~/Library/Application Support/Claude/config.json)：

{
  "mcpServers": {
    "Nate-MCP": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-server-container", "python", "-m", "mcp_server"]
    }
  }
}

⚙️ 環境變數配置摘要

變數	說明
MCP_API_KEYS	JSON 格式，定義多組 API Key 及其對應的 Tool 權限。
PYTHON_WORK_DIR	Python 隔離執行的工作目錄。
PLAYWRIGHT_CDP_ENDPOINT	遠端瀏覽器 CDP 連接點。
GMAIL_ACCOUNTS	Gmail OAuth 憑證配置。

詳細配置說明請參閱內部技術文檔或 .env.example。

---

提示：如果你是開發者，想了解代碼架構或新增 Tool，請查閱 docs/PROJECT_MAP.md。