Angela MCP

Angela MCP

Angela MCP是模型上下文协议服务器，负责编排Angela的工作区工作流，从上下文加载到分析包、课程管理和交付格式。

关键能力

• MCP服务器和工具注册 – src/index.ts 靴子a @modelcontextprotocol/sdk McpServer，加载工作区配置，并通过注册十几个工具 src/server/mcp-server.ts 共享Zod模式。
• 上下文感知编排 – src/server/tool-orchestrator.ts 集中工具执行、调用上下文加载器、工作区/分支管理器、笔记、Sherlock、课程、交付和复习助手，同时返回键入的内容 StandardToolResponse 有效载荷。
• 配置驱动的上下文加载 – config/angela-workspace.yaml 定义全局资源、课程文件、任务工作区默认值、分支/提交/PR策略和加载配置文件 ContextLoader, load-profiles.ts，以及 source-resolver.ts 为每个工具进行解释。
• 工件管理器 –任务说明(src/notes/task-notes-manager.ts)Sherlock编写者、课程提取/推广、交付格式化和提交/PR构建器封装了工具使用或生成的工作空间工件。
• 刀具目录 – src/server/tool-registry.ts 公开工具元数据、Zod模式 src/models/tool-contracts.ts，以及引导、探索、Sherlock分析、审查、关闭和交付流的加载配置文件。

项目结构

• src/config –YAML加载器和类型化配置定义。
• src/context –加载配置文件和源解析程序，以决定每个工具要读取哪些文件。
• src/server –工具编排器、MCP服务器接线、工具注册表和传输管道。
• src/lessons, src/sherlock, src/review, src/notes, src/delivery, src/workspace –特定领域的课程、Sherlock分析、代码审查、任务笔记、交付草稿、工作区和分支管理器。
• config/defaults –默认MCP运行时设置和引导指令。

如何跑步

1. 填充 config/angela-workspace.yaml 具有可从主机访问的路径。
2. npm install 收集依赖关系。
3. npm run dev 通过以下方式启动MCP服务器 tsx/stdio；使用 npm run build 之前 npm run start 在生产中。
4. 通过MCP工具驱动工作流程(bootstrap_task, run_sherlock_analysis, suggest_lesson_candidates, draft_pr_description等等）。

测试

npm run check 跨服务器和共享模块验证TypeScript类型。