MCP Agile Flow

MCP Agile Flow

site icon
2025.04.03 0
Python敏捷开发AI辅助开发IDE集成工作流管理开发效率
MCP Agile Flow 是一个全面的系统,用于管理AI辅助的敏捷开发工作流程。它采用基于资源的现代API设计,专注于RESTful API设计、资源优先架构和面向操作的工具。该系统提供敏捷文档生成、项目结构组织、IDE集成、工作流管理等功能,旨在简化集成并提高性能。
View on GitHub

Overview

基本能力

产品定位

MCP Agile Flow 是一个用于管理AI辅助敏捷开发工作流程的系统,专注于提供高效的开发工具和资源管理。

核心功能

  • 敏捷文档生成:自动生成和维护全面的AI文档。
  • 项目结构组织:使用AI生成的文件和目录组织项目。
  • IDE集成:直接与多种AI IDE(如Cursor、Windsurf、Cline)集成。
  • 工作流管理:跟踪敏捷故事和进度。
  • RESTful API设计:资源以RESTful层次结构组织。
  • 简化集成:直接映射到资源URI。
  • 性能优化:针对数据访问模式进行优化。

适用场景

  • AI辅助的敏捷开发项目。
  • 需要自动化文档生成和维护的项目。
  • 需要与多种IDE集成的开发环境。
  • 需要高效资源管理和工作流跟踪的团队。

工具列表

  • get-project-settings:获取项目设置,包括路径和环境变量。
  • initialize-ide:为特定IDE初始化项目目录结构。
  • initialize-ide-rules:为特定IDE初始化AI规则文件。
  • prime-context:分析项目文档并构建上下文理解。
  • migrate-mcp-config:在不同IDE之间迁移MCP配置。
  • think:记录复杂推理和逐步分析的思考。
  • get-thoughts:检索当前会话中记录的所有思考。
  • clear-thoughts:清除当前会话中记录的所有思考。
  • get-thought-stats:获取当前会话中思考的统计信息。
  • process-natural-language:处理自然语言命令并路由到适当的工具。

常见问题解答

  • 配置更新:如果之前配置过MCP Agile Flow,需要更新配置,因为fastmcp_server.py模块已被移除。
  • 自然语言命令:支持自然语言命令,但需要特定格式,否则会返回错误信息。

使用教程

使用依赖

  1. 确保已安装Python环境。

安装教程

  1. 安装包: pip install mcp-agile-flow
  2. 在代码中导入: ```python from mcp_agile_flow import call_tool, call_tool_sync

# 使用异步接口 result = await call_tool("get-project-settings", {})

# 或使用同步接口 result = call_tool_sync("get-project-settings", {}) ```

调试方式

  1. 从命令行运行服务器: ```bash # 使用Python(默认禁用日志) python -m mcp_agile_flow

# 启用普通日志 python -m mcp_agile_flow --verbose

# 调试模式(最详细的日志) python -m mcp_agile_flow --debug ```

开发

  1. 克隆仓库: git clone https://github.com/yourusername/mcp-agile-flow.git cd mcp-agile-flow
  2. 创建虚拟环境: python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
  3. 安装开发依赖: pip install -e ".[dev]"
  4. 运行测试: pytest

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。