{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pkdk7enkyff4","handle":"ai-dev-manager-mcp","url":"https://wellknown.network/agents/ai-dev-manager-mcp","links":{"self":"https://wellknown.network/agents/ai-dev-manager-mcp/record.json","html":"https://wellknown.network/agents/ai-dev-manager-mcp","markdown":"https://wellknown.network/agents/ai-dev-manager-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ai-dev-manager-mcp","status":"https://wellknown.network/api/v1/agents/ai-dev-manager-mcp/status","claim":"https://wellknown.network/agents/ai-dev-manager-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ai-dev-manager-mcp/claim.json","badge":"https://wellknown.network/agents/ai-dev-manager-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:ai-dev-manager-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ai-dev-manager-mcp","summary":"AI开发经理MCP服务 - 智能开发流程管理工具","description":"# AI开发经理 MCP服务\n\n一个基于FastMCP框架的智能开发经理服务，帮助AI有条不紊地完成从需求分析、迭代规划、任务拆解到生成开发报告的完整软件开发生命周期。\n\n## 🎯 项目概述\n\n本MCP服务扮演AI的\"开发经理\"角色，提供：\n\n- **项目状态机**: 作为项目元数据的唯一、可靠的数据源\n- **AI引导者**: 为AI提供结构清晰的工具集和上下文感知的引导提示\n\n### 核心特性\n\n- ✅ **自动感知工作目录**: 基于当前工作目录进行项目管理\n- ✅ **版本化迭代管理**: 支持语义化版本号和完整的迭代生命周期\n- ✅ **结构化数据存储**: 所有数据存储在`.cursor/devplan/`目录\n- ✅ **智能引导系统**: 根据开发阶段提供针对性指导\n- ✅ **原子性操作**: 确保数据一致性和操作安全性\n- ✅ **多种使用方式**: 支持MCP服务器和CLI两种模式\n\n## 📦 安装方式\n\n### 方式一：PyPI安装（推荐）\n\n```bash\n# 全局安装\npip install ai-dev-manager-mcp\n\n# 或使用pipx（推荐）\npipx install ai-dev-manager-mcp\n```\n\n### 方式二：使用uvx（一次性运行）\n\n```bash\n# 直接启动MCP服务器\nuvx ai-dev-manager-mcp\n\n# 在指定项目目录启动\nuvx ai-dev-manager-mcp -p /path/to/your/project\n```\n\n### 方式三：源码安装\n\n```bash\ngit clone https://github.com/yourusername/ai-dev-manager-mcp.git\ncd ai-dev-manager-mcp\npip install -e .\n```\n\n## 🚀 使用方式\n\n### MCP服务器模式（主要用法）\n\n#### 使用uvx（推荐）\n\n```json\n{\n  \"mcpServers\": {\n    \"ai-dev-manager\": {\n      \"command\": \"uvx\",\n      \"args\": [\"ai-dev-manager-mcp\", \"-p\", \"/your/project/directory\"]\n    }\n  }\n}\n```\n\n#### 使用pipx安装后\n\n```json\n{\n  \"mcpServers\": {\n    \"ai-dev-manager\": {\n      \"command\": \"ai-dev-manager-mcp\",\n      \"args\": [\"-p\", \"/your/project/directory\"]\n    }\n  }\n}\n```\n\n### 基本使用流程\n\n配置好Claude Desktop后，直接在对话中使用MCP工具：\n\n1. **获取项目上下文** - 调用 `get_project_context()` \n2. **开始新迭代** - 调用 `start_new_iteration(\"1.0.0\", \"项目需求描述\")`\n3. **拆解需求** - 调用 `decompose_goal_into_requirements(goal_id, requirements_list)`\n4. **生成任务** - 调用 `generate_tasks_for_requirement(requirement_id, tasks_list)`\n5. **跟踪进度** - 调用 `update_task_status(task_id, \"done\")`\n\n## 🛠️ 主要功能\n\n### MCP工具（Claude Desktop中使用）\n\n#### 类别一：上下文与引导工具\n\n- `get_project_context()` - 获取项目根目录、计划目录和当前活动迭代\n- `get_guidance(phase)` - 根据开发阶段提供引导建议\n\n#### 类别二：迭代管理工具\n\n- `start_new_iteration(version, prd)` - 创建新的开发迭代\n- `list_iterations()` - 列出所有历史迭代\n- `complete_iteration(version)` - 完成并归档指定迭代\n\n#### 类别三：规划与拆解工具\n\n- `decompose_goal_into_requirements(goal_id, requirements)` - 将目标拆解为功能需求\n- `generate_tasks_for_requirement(requirement_id, tasks)` - 为需求…","publisher":null,"homepage":"https://github.com/yourusername/ai-dev-manager-mcp#readme","repository":"https://github.com/yourusername/ai-dev-manager-mcp/issues","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["ai","claude","development","mcp","project-management"],"pricing":null,"endpoints":[{"url":"pypi:ai-dev-manager-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.project-management","name":"Project Management","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ai-dev-manager-mcp","registry":"pypi","observedAt":"2026-09-09T08:22:40.044Z","publishedAt":"2025-06-17T08:12:34.177476Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ai-dev-manager-mcp","url":"https://pypi.org/project/ai-dev-manager-mcp/","firstSeenAt":"2026-09-09T08:21:36.573Z","fetchedAt":"2026-09-09T08:21:36.573Z","normalizedAt":"2026-09-09T08:21:36.573Z"}]},"firstSeenAt":"2026-09-09T08:21:36.573Z","updatedAt":"2026-09-09T08:22:40.044Z"}