使用说明

MCP服务器管理中心

对所有MCP（模型上下文协议）服务器进行统一管理

集中式， 100%便携 用于管理多个MCP服务器的系统。非常适合开发团队-克隆一次，随处使用！

🌟 主要特点

✅ 自动Python检测 -在任何系统上查找Python 3.10+
✅ 零硬编码路径 -在任何克隆仓库的地方都可以使用
✅ 交叉平台的 -macOS、Linux、Windows
✅ 团队准备就绪 -整个公司可以使用相同的回购
✅ 一个命令设置 - make setup 你完了

🎯 概述

该项目提供了 便携式，团队就绪 管理MCP服务器的界面：

✅ 自动Python检测 -不再“在我的机器上工作”
✅ 动态路径分辨率 -在任何地方克隆，它都能正常工作
✅ 启用/禁用 不删除服务器
✅ Git子模块 用于版本控制
✅ 一个命令设置 - make setup 什么都做
✅ 平行安装 对于速度

🏗️ 建筑

auto-documentator/
├── mcp-config.json          # Central configuration (enable/disable, paths, etc.)
├── Makefile                 # Unified management interface
├── README.md                # This file
│
├── servers/                 # All MCP servers (as git submodules/repos)
│   ├── llm-prep/           # Context preparation server
│   ├── lazy-llms/          # Project management server
│   ├── serena/             # IDE-like semantic code tools
│   └── duckduckgo/         # Web search server
│
├── scripts/                 # Management Python scripts
│   ├── config_loader.py
│   ├── setup_all.py
│   ├── generate_install_cmd.py
│   ├── list_servers.py
│   ├── manage_servers.py
│   └── ...
│
└── docs/                    # Documentation
    └── ...

🚀 快速开始

1.检查你的环境

make doctor

这将检查所需的依赖关系和 自动检测 最好的Python版本：

Python 3.10+ （自动检测-使用python3.13、3.12、3.11或3.10）
Git
Claude CLI

系统将自动使用您计算机上可用的最佳Python版本！

2.列出可用服务器

make list

3.设置所有已启用的服务器

make setup

这将：

为基于Python的服务器创建虚拟环境
安装依赖项
并行设置每个已启用的服务器

4.获取Claude安装命令

make install-cmd

这产生和 复制到剪贴板 在Claude中安装所有启用的MCP服务器的命令。

5.在Claude中安装

在终端中粘贴并运行步骤4中的命令：

# The command will look like:
claude mcp add llm-prep -- /path/to/venv/bin/python /path/to/src/server.py --transport stdio && \
claude mcp add lazy-llms -- /path/to/venv/bin/python /path/to/src/pm_server.py --transport stdio

📦 可用的MCP服务器

服务器	类型	状态	描述
llm准备 python✅ 已启用	LLM上下文准备-创建全面的上下文文档
懒惰的llms python✅ 已启用	项目管理-使用git集成创建和管理PM节点
鸭鸭 python✅ 已启用	DuckDuckGo搜索-克劳德的网络搜索功能
阿特拉斯	NPX远程	✅ 已启用	Atlassian服务访问（Jira、Confluence）-远程托管服务器
塞雷娜	UVX	❌ 禁用	类似IDE的语义代码工具（LSP、符号搜索、重构）

🛠️ 常用命令

服务器管理

make list                    # List all servers (enabled/disabled)
make status                  # Show setup status of all servers
make enable NAME=serena      # Enable a server
make disable NAME=duckduckgo # Disable a server

设置

make setup                   # Setup all enabled servers
make setup-one NAME=llm-prep # Setup a specific server
make update-all              # Update all servers (git pull)

安装

make install-cmd             # Get install command for enabled servers (copies to clipboard)
make install-cmd-all         # Get install command for ALL servers

公用事业

make doctor                  # Check environment and dependencies
make clean                   # Clean build artifacts and caches
make reset                   # Full reset (removes all venvs)

📝 配置

所有服务器配置都在 mcp-config.json:

{
  "version": "1.0.0",
  "servers": {
    "llm-prep": {
      "enabled": true,
      "type": "python-local",
      "submodule_path": "servers/llm-prep",
      "description": "LLM Context Preparation",
      "setup_command": "python3 -m venv venv && venv/bin/pip install -r requirements.txt",
      "python_path": "servers/llm-prep/venv/bin/python",
      "entry_point": "servers/llm-prep/src/mcp_server_fastmcp.py",
      "args": ["--transport", "stdio"]
    }
  }
}

服务器类型

python-local：直接执行Python脚本
python-module：使用执行的Python模块 -m
uvx：服务器通过安装 uvx （适用于serena等套餐）
npx-remote：通过访问远程MCP服务器 npx mcp-remote （无需本地设置）

🔧 添加新服务器

选项1：交互式（推荐）

make add-server

这将交互式地提示您：

服务器名称
Git存储库URL
服务器类型
描述
设置命令

选项2：手动

将服务器添加到 servers/ 目录:

cd servers
git submodule add https://github.com/org/my-server.git my-server

将配置添加到 mcp-config.json:

{
  "my-server": {
    "enabled": true,
    "type": "python-local",
    "submodule_path": "servers/my-server",
    "git_url": "https://github.com/org/my-server.git",
    "description": "My awesome MCP server",
    "setup_command": "python3 -m venv venv && venv/bin/pip install -r requirements.txt",
    "python_path": "servers/my-server/venv/bin/python",
    "entry_point": "servers/my-server/src/server.py",
    "args": ["--transport", "stdio"]
  }
}

设置服务器:
```
make setup-one NAME=my-server
```
生成安装命令:
```
make install-cmd
```

📚 服务器详细信息

llm准备

上下文准备服务器，帮助为LLM工作流创建全面的markdown上下文文档。

特征：

生成项目树结构
将多个文件合并到上下文文档中
智能文件过滤和忽略模式
令牌高效输出格式

用途：

# Available tools:
- prepare_context: Create comprehensive context documents
- create_debug_notes: Save markdown notes
- set_project_config: Configure project settings

懒惰的llms

项目管理服务器，集成Git，用于创建和管理PM节点。

特征：

使用Jira样式ID创建PM节点
Git集成工作流
分支提示和提交模板
人类可读的标记格式

用途：

# Available tools:
- pm_create_node: Create new PM node
- pm_update_status: Update node status
- pm_get_node: Read node details
- git_add_commit: Commit with PM format

鸭鸭

使用DuckDuckGo的网络搜索功能。

特征：

从克劳德那里搜索网络
不需要API密钥
注重隐私

阿特拉斯

用于访问Jira和Confluence等Atlassian服务的远程MCP服务器。

特征：

远程托管服务器（无需本地设置）
访问Jira问题和公告板
搜索并阅读Confluence页面
需要Atlassian帐户身份验证

注：这是Atlassian托管的远程服务器。无需本地安装。

serena（可选）

类似IDE的语义代码工具与LSP集成。

特征：

符号级代码导航
查找参考文献和定义
智能代码编辑
20多种编程语言

注：需要 uv 待安装。启用 make enable NAME=serena.

⚙️ 需求

Python 3.10或更高版本 -MCP服务器需要Python 3.10+
Git -用于管理服务器存储库
Claude CLI -在Claude中安装MCP服务器
紫外线的 （可选）-仅当您想启用Serena时才需要

检查你的Python版本：

python3.12 --version  # Or python3.10, python3.11

如果你只有Python 3.9或更早版本，你需要安装一个更新的版本。

🐛 故障排除

安装过程中出现Python版本错误？

MCP服务器需要 Python 3.10或更高版本如果你看到类似“requires Python>=3.10”这样的错误：

检查可用的Python版本：

python3.10 --version
python3.12 --version

系统自动使用 python3.12。如果没有，请安装它：
- macOS: brew install python@3.12
- Linux: sudo apt install python3.12 或 sudo yum install python3.12

服务器没有出现在Claude中？

检查服务器是否已启用：
```
make list
```
检查服务器状态：
```
make status
```
验证设置：
```
make setup-one NAME=server-name
```
重新生成安装命令：
```
make install-cmd
```

安装失败？

运行诊断程序：

make doctor

检查特定服务器：

make status

清白？

make reset    # Removes all venvs
make setup    # Re-setup everything

🤝 贡献

这是开发团队的内部MCP服务器中心。添加新的MCP服务器时：

将服务器创建为单独的git存储库
将其作为子模块添加到 servers/
更新 mcp-config.json 包含服务器详细信息
测试用 make setup-one NAME=your-server
将更改提交到此中心存储库

📄 许可证

每个MCP服务器 servers/ 有自己的许可证。这个管理中心是麻省理工学院授权的。

🔗 链接

Claude代码文档
MCP规范
单个服务器存储库（添加指向团队仓库的链接）

由以下材料制成❤️ 由您的开发团队

跑 make help 查看所有可用命令

使用说明

MCP服务器管理中心

🌟 主要特点

🎯 概述

🏗️ 建筑

🚀 快速开始

1.检查你的环境

2.列出可用服务器

3.设置所有已启用的服务器

4.获取Claude安装命令

5.在Claude中安装

📦 可用的MCP服务器

🛠️ 常用命令

服务器管理

设置

安装

公用事业

📝 配置

服务器类型

🔧 添加新服务器

选项1：交互式（推荐）

选项2：手动

📚 服务器详细信息

llm准备

懒惰的llms

鸭鸭

阿特拉斯

serena（可选）

⚙️ 需求

🐛 故障排除

安装过程中出现Python版本错误？

服务器没有出现在Claude中？

安装失败？

清白？

🤝 贡献

📄 许可证

🔗 链接

相关 MCP

Figma MCP服务器

浏览器自动化MCP服务器

Markdown转换服务

MCP 协议测试服务器

图像生成服务

代码安全扫描工具