模型上下文协议服务器

使用Docker Compose设置模型上下文协议(MCP)服务器,包括Git、文件系统、PostgreSQL、内存和检查器等功能。

  • by ajoslin103
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 ajoslin103/mcp-servers

使用说明

MCP服务器

本项目使用Docker Compose设置模型上下文协议(MCP)服务器。

包含的服务器

  • Git -读取、搜索和操作Git存储库
  • 文件系统 -通过可配置的访问控制实现安全的文件操作
  • PostgreSQL -通过模式检查进行数据库访问
  • 记忆 -基于知识图的持久存储系统
  • 检查员 -用于管理和调试MCP服务器的GUI工具(使用npx在本地运行)

设置

  1. 初始化存储库:
./scripts/init-repo.sh

这将:

  • 使用nvm设置正确的Node.js版本
  • 全局安装MCP检查器
  1. 启动容器化服务器:
docker compose up -d
  1. 在本地启动MCP检查器:
./scripts/start-inspector.sh
  1. 停止MCP检查员:
./scripts/stop-inspector.sh
  1. 停止容器化服务器:
docker compose down

目录结构

  • docker-data/ -每个MCP服务器的数据目录
  • docker-files/ -Dockerfile资源
  • scripts/ -用于管理服务的实用程序脚本
    • init-repo.sh -使用正确的Node.js和包初始化存储库
    • start-inspector.sh -在后台启动MCP检查器
    • stop-inspector.sh -停止MCP检查员
    • 模板:
    • template-start-mcp-server.sh -用于为MCP服务器创建启动脚本的模板
    • template-stop-mcp-server.sh -用于为MCP服务器创建停止脚本的模板

配置

每个服务器都可以通过docker-compose.yml文件中的环境变量进行配置。

访问检查员

MCP检查员将在http://localhost:5173在从脚本开始之后。

日志

  • 检查员日志存储在 ./docker-data/inspector/inspector.log

添加新的MCP服务器

要添加在本地运行的新MCP服务器(非停靠):

  1. 复制模板脚本:
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
  1. 编辑两个脚本以设置:
  • SERVER_NAME -服务器名称
  • NPX_COMMAND -运行服务器的NPX命令
  • PORT -服务器运行的端口
  1. 确保全局安装服务器包或在NPX命令中指定它。