项目简介
Minsky是一个命令行工具,旨在帮助AI智能体在代码库上更有效地协作。它通过模拟人类软件工程师常用的工作流程(如Git分支、会话隔离、任务跟踪等),为AI智能体提供结构化的上下文和调用能力。Minsky还集成了对Model Context Protocol (MCP) 的支持,允许兼容的AI客户端直接与Minsky的功能进行交互。
主要功能点
- MCP服务器: 以标准化的JSON-RPC协议,通过Stdio、SSE等传输方式向AI智能体提供访问接口。
- 会话管理: 为每个开发任务创建隔离的工作空间(Git仓库克隆),避免不同智能体或任务间的冲突。
- 任务管理: 支持基于Markdown文件的任务清单,允许智能体获取、创建、更新任务状态。
- Git工作流: 提供Git克隆、分支、提交、推送和生成拉取请求(PR)描述等功能,供智能体调用。
- 规则管理: 定义和获取项目相关的规则,为智能体提供遵循的指南。
安装步骤
- 克隆仓库:'git clone https://github.com/edobry/minsky.git'
- 进入目录:'cd minsky'
- 安装依赖(需要安装Bun):'bun install'
- 全局链接(可选,以便在任何地方运行 'minsky' 命令):'bun link'
MCP服务器配置
MCP客户端需要配置Minsky MCP服务器的启动信息。这些信息通常存储在客户端的配置文件中,例如 '.cursor/mcp.json' 文件(具体的路径和格式取决于您使用的MCP客户端)。
配置内容会指定如何启动Minsky服务器进程以及使用哪种传输方式。
- 要使用通过 Stdio 传输(通常用于本地集成),配置中会指定命令为 'minsky',参数为 'mcp start --stdio'。
- 对于需要通过网络访问(如 SSE 或 HTTP Stream)的场景,参数会包含传输类型、端口和主机名,例如 'mcp start --sse --port 8080 --host localhost'。
MCP客户端会读取这些配置信息,自动执行指定的命令来启动 Minsky 服务器进程,然后通过对应的传输方式(如标准输入输出、SSE连接)与服务器建立连接并发送 JSON-RPC 请求。
基本使用方法
Minsky 主要作为命令行工具使用,您可以通过 'minsky [命令] [选项]' 直接执行其各项功能,例如:
- 'minsky session start --task #123'
- 'minsky tasks list'
- 'minsky git pr --session my-feature'
当作为MCP服务器使用时,您无需直接执行 'minsky mcp start' 命令。兼容MCP协议的AI客户端会自动读取配置并启动Minsky服务器进程,然后通过MCP协议调用其暴露的任务、会话、Git等工具。您只需要确保Minsky已正确安装,并且您的AI客户端配置了Minsky MCP服务器的启动信息即可。
信息
分类
开发者工具