MCP负责人
PrincipalMD的模型上下文协议服务器捆绑包。此包反映了 agent-hooks 工作流，以便团队可以通过以下方式运行MCP服务器 npx 或者在本地安装，而无需克隆完整的Electron应用程序。
安装和快速启动
# one-off execution
npx @principal-ai/principal-mcp
# or install globally
npm install -g @principal-ai/principal-mcp
principal-mcp配置
| 选项 | 描述 | 默认值 |
|---|---|---|
--port, PRINCIPLE_MCP_PORT | 提示和依赖工具共享的MCP网桥端口 | 3043 |
--host, PRINCIPLE_MCP_HOST | MCP网桥主机 | localhost |
PRINCIPLE_MCP_PROTOCOL | 从CLI工具联系ADE HTTP桥时使用的协议 | http |
CLI读取与Electron应用程序相同的环境变量，因此它可以通过统一的ADE网桥路由请求。当网桥脱机时，依赖性任务会回退到Memory Palace存储（需要磁盘上的存储库根）。
包含MCP工具
| 工具 | 目的 |
|---|---|
submit_dependency_task | 向ADE提交依赖任务；如果网桥不可用，则使用Memory Palace在本地持久化任务。 |
submit_task | 向ADE提交具有可配置挂起队列路径的任务；推荐过 submit_dependency_task. |
get_dependency_task_doc | 解析存储在Memory Palace中的依赖关系任务文档的绝对路径。 |
add_memory_note | 在存储库的记忆宫中创建锚定笔记，以存储开发见解。 |
resolve_project | 获取全面的项目信息，包括元数据、权限、本地克隆和远程详细信息。 |
包布局
principal-mcp/
docs/ # Design notes
src/
index.ts # CLI entry point
server/ # MCP server implementation
tools/ # Tool implementations (dependency & memory tools)
types/, utils/ # Shared types & helpers
scripts/bundle.ts # Bun-based esbuild bundler
tests/ # Bun test suite
dist/ # Generated bundle after build发展
# install dependencies
bun install
# run tests
bun test
# build the distributable bundle
bun run build
# publish (runs clean → build → test automatically)
运行时注意事项
- MCP交互使用单个HTTP网桥端口（默认
3043)用于依赖工作流。 - 当
submit_dependency_task无法到达ADE，它通过记忆宫继续执行任务；repositoryRoot必须在该场景中提供，以便CLI可以定位git根。 get_dependency_task_doc直接从Memory Palace读取，以提供活动或已完成任务文档的路径。add_memory_note在存储库的记忆宫中本地创建锚定笔记，而不需要桥接连接。
资源
- 原始实施参考：
PrincipleMD/core/src/mcp/* - 核心库依赖关系：
@a24z/core-library（提供Memory Palace+文件系统适配器） - MCP-SDK：
@modelcontextprotocol/sdk