MCP Servers Vo1

該項目通過Docker Compose搭建了多種Model Context Protocol (MCP)服務，包括Git操作、文件系統、PostgreSQL數據庫、知識圖譜存儲及可視化調試工具，提供完整的本地開發環境部署方案。

開發者工具知識管理與記憶 #容器化部署 #協議服務 #知識圖譜 #調試工具

評分 : 2分

下載量 : 8

更新時間 : 2025-04-23

什麼是MCP服務器?

MCP服務器是一組模塊化服務，為AI系統和開發者提供標準化的數據訪問接口。通過統一協議連接Git倉庫、文件系統、數據庫等數據源，實現安全可控的數據操作環境。

如何使用MCP服務器?

通過簡單的Docker命令即可啟動所有服務，使用內置的Inspector可視化工具進行管理和調試。無需複雜配置即可獲得完整的數據操作能力。

適用場景

適用於AI代理開發、自動化數據處理、知識管理系統構建等場景。特別適合需要安全訪問多種數據源的智能應用開發。

主要功能

Git倉庫操作提供完整的Git倉庫讀寫、搜索和歷史追溯能力，支持遠程倉庫克隆和本地倉庫管理

安全文件系統帶權限控制的文件操作接口，可配置不同級別的訪問權限保障數據安全

數據庫管理PostgreSQL數據庫連接與模式檢查功能，支持SQL查詢和數據操作

知識圖譜存儲基於知識圖譜的持久化記憶系統，支持複雜關係數據的存儲和查詢

可視化調試圖形化界面管理所有MCP服務器，即時查看日誌和調試接口調用

優勢與侷限性

優勢

開箱即用的容器化部署，無需複雜環境配置

統一協議對接多種數據源，降低集成複雜度

細粒度的權限控制保障數據安全

可視化調試工具提升開發效率

侷限性

目前僅支持PostgreSQL數據庫

內存服務需要額外學習知識圖譜概念

Inspector工具需要本地Node.js環境

如何使用

環境準備

確保已安裝Docker和Node.js環境

初始化倉庫

運行初始化腳本自動配置Node版本和安裝依賴

啟動服務

使用Docker Compose啟動所有MCP服務器

使用Inspector

啟動可視化調試工具管理服務器

使用案例

自動化文檔處理通過文件系統服務批量處理文檔，同時用Git服務管理版本歷史

知識庫構建結合內存服務和數據庫服務構建結構化知識庫

常見問題

Inspector工具無法啟動怎麼辦?

如何添加新的數據源?

數據存儲在什麼位置?

🚀 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