MCP Servers Vo1

🚀 MCP 服務器設置指南

本項目藉助 Docker Compose 來部署 Model Context Protocol (MCP) 服務器，為用戶提供便捷的服務器部署方案，助力高效管理和使用 MCP 相關服務。

🚀 快速開始

本項目使用 Docker Compose 部署 Model Context Protocol (MCP) 服務器，以下為你詳細介紹操作步驟。

✨ 主要特性

包含的服務器

• Git：可用於讀取、搜索和操作 Git 倉庫，方便進行代碼管理。
• 文件系統：提供帶有可配置訪問控制的安全文件操作，保障文件數據安全。
• PostgreSQL：支持數據庫訪問及架構檢查，滿足數據存儲和管理需求。
• 內存：基於知識圖譜的持久記憶系統，有效存儲和利用知識信息。
• Inspector：作為管理和調試 MCP 服務器的 GUI 工具，可通過 npx 本地運行，提升管理效率。

📦 安裝指南

初始化倉庫

./scripts/init-repo.sh

此命令會執行以下操作：

• 利用 nvm 設置正確的 Node.js 版本。
• 全局安裝 MCP Inspector。

啟動容器化服務器

docker compose up -d

本地啟動 MCP Inspector

./scripts/start-inspector.sh

停止 MCP Inspector

./scripts/stop-inspector.sh

停止容器化服務器

docker compose down

📚 詳細文檔

目錄結構

• docker-data/：每個 MCP 服務器的數據目錄。
• docker-files/：Dockerfile 資源文件。
• scripts/：管理服務的實用腳本。
  • init-repo.sh：初始化倉庫以正確設置 Node.js 和包。
  • start-inspector.sh：在後臺啟動 MCP Inspector。
  • stop-inspector.sh：停止 MCP Inspector。
  • 模板文件夾：
    • template-start-mcp-server.sh：創建啟動腳本的模板用於 MCP 服務器。
    • template-stop-mcp-server.sh：創建停止腳本的模板用於 MCP 服務器。

配置

每個服務器可通過 docker-compose.yml 文件中的環境變量進行配置。

訪問 Inspector

MCP Inspector 啟動後，可通過 http://localhost:5173 進行訪問。

日誌記錄

Inspector 日誌位於 ./docker-data/inspector/inspector.log。

添加新的 MCP 服務器

若要添加一個新的本地運行（非 Docker 化）的 MCP 服務器，可按以下步驟操作：

複製模板腳本

cp scripts/template-start-mcp-server.sh scripts/start-newserver.sh
cp scripts/template-stop-mcp-server.sh scripts/stop-newserver.sh
chmod +x scripts/start-newserver.sh scripts/stop-newserver.sh

編輯腳本設置參數

編輯兩個腳本以設置以下參數：

• SERVER_NAME：服務器名稱。
• NPX_COMMAND：運行服務器的 npx 命令。
• PORT：服務器運行的端口。

安裝服務器包

確保安裝服務器包或在 npx 命令中指定它。