MCP服务器项目经理
用于管理任何开发项目的模型上下文协议（MCP）服务器。具有安全的文件操作，包括审计日志记录、跨平台shell命令执行、具有本地存储的智能上下文管理和全面的项目管理工具。
目的
此MCP服务器提供用于管理任何软件项目的开发工具，具有内置的安全机制和智能上下文管理。最初的设计考虑了VSCode扩展开发，它完全适用于任何项目类型。
特性
Shell命令执行
- 超时保护：命令自动超时以防止挂起
- 交叉平台的：适用于Windows（cmd/PowerShell）和Unix系统（bash/sh）
- 流程管理：自动清理活动进程
- 错误处理：全面的错误报告和处理
安全项目管理
- 多项目支持：管理MCP服务器项目和任何目标项目
- 安全文件操作：使用锁定文件的暂存功能读取、创建和编辑文件
- 智能过滤：排除构建工件和不必要的文件
- 路径验证：防止访问项目边界之外
可配置的项目集成
- 双项目设计：管理MCP服务器文件和目标项目
- 适应性结构：易于为不同的项目类型进行配置
- 模块化架构：根据需要使用特定于项目的工具进行扩展
本地上下文管理
- 纯本地存储：无外部依赖关系-使用简单的JSON文件
- 智能文本分析：自动提取关键决策、问题和解决方案
- 关键字搜索：具有相关性评分的快速本地搜索
- 分层上下文：多层次的细节（摘要、决策、事件）
- 事件驱动存储：仅存储重大开发事件
- 上下文清理：存储大小的自动管理
安全第一设计
- 使用日志记录移动文件：移动操作执行审计跟踪（无覆盖）
- 不直接删除文件：删除操作创建日志以供手动查看
- 日志文件重命名：重命名操作创建手动执行日志
- 阶段系统：锁定的文件被暂存以供手动审查
- 审计跟踪：所有操作都记录了详细信息
- 人工监督：破坏性操作需要人工确认
可用工具
shell命令
execute_command：执行任何具有超时保护的shell命令get_platform_info：获取当前平台和shell信息
MCP项目管理
- MCP项目目录中的文件读/写操作
- 目录列表和导航
- 文件暂存和编辑
- 使用日志记录移动：执行带有审计跟踪的移动（无覆盖）
- 安全重命名/删除：创建手动执行日志（请参见 安全指南)
目标项目管理
- 项目目录中的文件读/写操作
- 目录列表和导航
- 文件暂存和编辑
- 使用日志记录移动：执行带有审计跟踪的移动（无覆盖）
- 安全重命名/删除：创建手动执行日志
本地上下文管理
end_session_summary：通过关键短语提取保存会话见解record_significant_event：跟踪重要的发展里程碑save_context_levels：在多个细节级别存储上下文start_with_context：从最近的会话中检索上下文get_relevant_context：获取特定任务的上下文search_context：使用相关性评分在存储的上下文中搜索get_context_stats：查看有关存储上下文的统计信息clear_old_context：清理旧上下文条目
安装
- 克隆此存储库
- 安装依赖项：
pip install mcp- 在中配置目标项目路径
main.py:
# Update this path to point to your project
TARGET_PROJECT_RELATIVE_PATH = "../your-project"用法
启动MCP服务器：
python main.py服务器将初始化并通过MCP协议提供对所有可用工具的访问。
快速入门指南
- 配置目标项目 （目标项目工具所需）：
# In main.py, update this line to point to your project:
TARGET_PROJECT_RELATIVE_PATH = "../my-react-app"- 基础上下文管理:
# At end of productive session
end_session_summary("Fixed database connection issues and optimized queries", ["debugging", "database"])
# At start of new session
start_with_context(3)
# Record significant achievements
record_significant_event("error_solved", "Fixed memory leak in data processing pipeline")看 CONTEXT_MANAGER_GUIDE.md 了解详细的上下文管理用法。
安全指南
重要：此服务器立即执行移动操作（使用审核日志记录），但出于安全考虑，不允许直接删除或重命名文件。删除和重命名操作会创建日志以供手动查看和执行。看 安全_吉德利斯.md 了解完整细节。
建筑
project-manager-mcp-server/
├── main.py # Server entry point
├── tools/
│ ├── shell_mcp_server.py # Shell command execution
│ ├── mcp_project_manager.py # MCP server project management
│ ├── base_project_manager.py # Base project management class
│ ├── efficient_context_manager.py # Local context management
│ └── skip_patterns.py # File filtering patterns
├── context_storage/ # Local JSON context storage
├── logs/ # Operation logs (moves/deletes)
├── .staging/ # Staged file changes
├── README.md
├── CONTEXT_MANAGER_GUIDE.md # Detailed context management guide
├── SAFETY_GUIDELINES.md # File operation safety policies
└── TODO.md # Development roadmap and future features配置
添加您的项目
- 更新
main.py指向您的项目：
TARGET_PROJECT_RELATIVE_PATH = "../your-project-name"- 通过扩展创建自定义项目管理器（可选）
BaseProjectManager:
class YourProjectManager(BaseProjectManager):
def register_specific_tools(self):
# Add project-specific tools here
pass自定义文件筛选
编辑 tools/skip_patterns.py 要自定义排除哪些文件和目录：
SKIP_DIRS.add('your_custom_dir')
SKIP_FILES.add('your_custom_file.ext')路线图和未来功能
看 TODO.md 完整的开发路线图，包括：
- 优雅的错误处理 用于启动组件故障
- Git集成 具有完整版本控制操作
- 增强的外部工具支持 在shell命令中
- 黑曜石融合 知识管理
- 改进的体系结构 测试覆盖率
设计理念
安全第一
- 无破坏性操作：移动/删除创建日志，而不是执行
- 人工监督：关键操作需要人工审查
- 审计跟踪：所有操作都记录了详细的说明
- 分阶段更改：锁定的文件被暂存以供审查
通用设计
- 项目不可知：适用于任何代码库或项目类型
- 模块化架构：易于扩展以满足特定项目需求
- 可配置路径：任何项目结构的简单设置
- 跨平台：跨操作系统的一致行为
本地优先上下文管理
- 无外部依赖关系：使用简单的JSON文件进行存储
- 智能文本分析：自动提取关键决策、问题和解决方案
- 快速关键字搜索：具有相关性评分的本地搜索
- 分级存储：针对不同需求的不同细节级别
- 零成本：不需要API费用或订阅
本地第一数据
- 所有数据都保留在您的机器上：存储在本地JSON文件中的上下文
- 无网络依赖关系：完全离线工作
- 快速启动：没有API初始化延迟
- 轻松备份：只需复制
context_storage目录
项目集成示例
此MCP服务器适用于：
- Web应用程序：React、Vue、Angular项目
- 后端服务：Node.js、Python、Go、Rust项目
- 移动应用：React Native、Flutter项目
- 桌面应用程序：电子、Tauri项目
- 文档网站：Jekyll、Hugo、GitBook项目
- VSCode扩展：Types/JavaScript扩展项目
鸣谢
贡献
欢迎投稿！该项目旨在促进任何软件开发工作流程，并可适应各种项目类型和开发环境。
添加项目特定功能
- 创建一个新的项目经理类，扩展
BaseProjectManager - 在中添加特定于项目的工具
register_specific_tools()方法 - 更新
main.py使用自定义项目管理器 - 提交带有您的增强功能的PR！
需求
- Python 3.12+
- MCP框架
- 不需要外部API密钥
- 完全离线工作