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 命令中指定它。