用途
just-mcp 是一个面向 Just 命令运行器的 MCP（Model Context Protocol）服务器。它让 AI 助手能够通过标准化 MCP 协议发现、执行和自省 Justfile 中的配方（recipes）。其核心目的是为 LLM 提供比直接 bash 访问更安全、更节省上下文的命令执行抽象。
主要能力
- 完整的 MCP 服务器：集成 rmcp 0.3.0，兼容 MCP 2024-11-05 协议。
- 配方发现：解析并列出 Justfile 中所有可用的配方。
- 配方执行：执行配方，支持参数，并捕获结构化输出。
- 配方自省：获取配方的详细信息、参数和文档。
- Justfile 校验：进行语法和语义验证，并报告错误。
- 环境管理：支持 .env 文件与变量展开。
- 测试覆盖：集成测试与单元测试共 33 项通过。
MCP 工具
- list_recipes：列出 justfile 中所有可用配方。
- run_recipe：执行指定配方，可带可选参数。
- get_recipe_info：获取指定配方的详细信息。
- validate_justfile：校验 justfile 的语法和语义错误。
使用方式
安装方式包括 pkgx、Docker 镜像以及 Claude Desktop 集成（需将 just-mcp 添加到 Claude Desktop 的 MCP 配置中）。pkgx 会下载平台对应的 tarball，将可执行文件解压到 ${PKGX_DIR:-$HOME/.pkgx}/bin，并以传入参数运行 CLI；如需长期使用，需将该 bin 目录加入 shell 的 PATH。Docker 镜像标签包括 latest、X.Y.Z、X.Y、X。
适用场景
just-mcp 适合进行智能体执行（agent execution）的用户。它的优势包括：
- 极低开销，可能优于其他同类工具。
- 对人类友好，justfile 易于人类阅读，对 LLM 开销也低。
- 快速简单，适合偏好轻量方案的场景。
- 对小型模型友好，适合自托管 GPU/CPU 开源模型，适用于 8k-32k 上下文限制。
Just 支持引入以下安全模式：透明日志记录而不干扰智能体；使用小模型在命令执行前扫描“是否有害”；类似 Python 装饰器的命令校验模式；基于 git 仓库的幂等执行。
当前状态与限制
项目当前完成度约 67%（8/12 核心任务）。已实现功能包括完整 MCP 服务器、配方发现、配方执行、配方自省、Justfile 校验、环境管理、完整测试覆盖。剩余任务包括：LSP 风格补全系统、增强诊断、虚拟文件系统（支持 stdin、远程源和内存缓冲区）、发布准备（文档、CI/CD、crate 发布）。未来增强方向包括：自定义配方类型的插件系统、与其他构建工具集成、大 justfile 的性能优化、高级依赖可视化。
技术栈使用 Rust 1.82+（async/await）、rmcp 0.3.0、serde/serde_json、snafu、tokio。项目采用 MIT 许可证。相关项目包括 Just、MCP 协议、rmcp，以及 just-vscode、just-awesome-agents 等。
