MCP Servers

Name: MCP Servers
Author: ajoslin103

本地服务

github.com/ajoslin103开发工具084 周前更新

代码仓库

关于 MCP Servers

MCP Servers 使用 Docker Compose 配置一组 MCP 服务，并附带管理生命周期的脚本和本地 MCP Inspector。它面向需要一同运行和管理 Git、文件系统、PostgreSQL 与 Memory 服务的场景。

主要功能

01使用 Docker Compose 配置服务
02Git 仓库操作
03受控的文件系统访问
04PostgreSQL 架构检查
05持久化知识图谱记忆
06本地 MCP Inspector

适用场景

01一同运行多个 MCP 服务
02通过 PostgreSQL 检查数据库架构
03使用 Inspector 管理和调试服务
04通过脚本模板添加本地服务

MCP 相关

它通过 Docker Compose 运行 Git、Filesystem、PostgreSQL 和 Memory MCP 服务，并提供 MCP Inspector 进行本地管理与调试。脚本模板可用于添加本地运行的服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "servers-ajoslin103": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}

启动命令docker run -i --rm compose

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocicomposestdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP 服务

此项目使用 Docker Compose 设置 Model Context Protocol（MCP）服务。

包含的服务

Git - 读取、搜索和操作 Git 仓库
Filesystem - 通过可配置的访问控制安全地操作文件
PostgreSQL - 访问数据库并检查架构
Memory - 基于知识图谱的持久化记忆系统
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

使用脚本启动后，可通过 http://localhost:5173 访问 MCP Inspector。

日志

Inspector 日志存储在 ./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