Atlas Work MCP Server
使用说明
- 项目简介 Atlas 提供一个 MCP 服务器实现，核心在于通过一组工作相关工具（如路径锁/解锁等）来管理并发工作、会话和上下文，便于 LLM 客户端在统一协议下调用外部功能、访问资源以及获取提示模板等上下文信息。
- 主要功能点
- 注册并暴露工作相关工具（Tools），如路径锁定与状态查询，方便在多进程/多任务环境中安全地并发执行。
- 提供会话与锁管理的后端支撑，帮助确保对共享资源的互斥访问和 crash 恢复能力。
- 通过 MCP 协议实现工具执行和结果反馈，支持标准的 JSON-RPC 形式的请求与响应。
- 使用标准化的 stdio 传输，便于容器化部署与守护进程集成。
- 安装步骤
- 安装 Bun 运行时（仓库使用 Bun 来执行 TypeScript/JS 代码）。
- 获取代码：git clone https://github.com/mxzinke/atlas
- 启动 MCP 服务器（示例，不同环境可按需调整路径）： bun run /atlas/app/atlas-mcp/index.ts
- 为 MCP 客户端配置启动命令与参数（见下方“服务器配置”中的示例）。
- 服务器配置（MCP 客户端需要知道如何启动服务器才能连接）
下面给出一个基于仓库实现的准确配置示例，包含 server name、command、args 等字段，供 MCP 客户端使用以建立连接。
{
"server_name": "work-mcp",
"command": "bun",
"args": ["run", "/atlas/app/atlas-mcp/index.ts"],
"transport": "stdio",
"version": "3.0.0"
}
说明：
- server_name 对应代码中 MCP 服务器的名称（atlas 中实现的 name 为 "work-mcp"）。
- command 与 args 指定了启动 MCP 服务器的可执行程序及参数，示例使用 Bun 运行 /atlas/app/atlas-mcp/index.ts。
- transport 指定传输方式，这里为 stdio，与代码实现的 StdioServerTransport 对应。
- 基本使用方法
- 客户端通过上述配置启动并连接到 MCP 服务器后，可以按 MCP 规范向服务器请求工具执行、资源访问等能力。
- 在 Atlas 的实现中，当前暴露的工具包括路径锁相关工具（path_lock、path_unlock、path_lock_status），用于在工作任务中保护共享的目录。
- 服务器启动后，客户端通过 MCP 请求来调用工具，服务器返回标准的 MCP 响应格式，前后端会话管理和日志均在服务器端处理。