使用说明
MCP服务器
本项目使用Docker Compose设置模型上下文协议(MCP)服务器。
包含的服务器
- Git -读取、搜索和操作Git存储库
- 文件系统 -通过可配置的访问控制实现安全的文件操作
- PostgreSQL -通过模式检查进行数据库访问
- 记忆 -基于知识图的持久存储系统
- 检查员 -用于管理和调试MCP服务器的GUI工具(使用npx在本地运行)
设置
- 初始化存储库:
./scripts/init-repo.sh
这将:
- 使用nvm设置正确的Node.js版本
- 全局安装MCP检查器
- 启动容器化服务器:
docker compose up -d
- 在本地启动MCP检查器:
./scripts/start-inspector.sh
- 停止MCP检查员:
./scripts/stop-inspector.sh
- 停止容器化服务器:
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服务器(非停靠):
- 复制模板脚本:
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命令中指定它。