MCP Agile Flow

🚀 MCP 敏捷流程

MCP 敏捷流程是一個基於 FastMCP 的現代化資源庫，專注於管理 AI 輔助的敏捷開發工作流。它通過規範化的 RESTful 接口、以資源為核心的架構設計以及專門的操作工具，為開發團隊提供高效、便捷的項目管理解決方案。

🚀 快速開始

安裝

pip install mcp-agile

導入

from mcp_agile import process_natural_language

# 示例用法：
result = process_natural_language("migrate mcp config to claude-desktop")

命令行使用

安裝完成後，可以通過命令行訪問工具：

mcp-agile --help

✨ 主要特性

• 敏捷文檔生成：自動生成項目文檔，節省時間和精力。
• 項目結構管理：優化和管理項目結構，提高項目的可維護性。
• 團隊協作：增強團隊內部的協作能力，促進信息共享和溝通。
• 代碼審查：提供代碼質量檢查，確保代碼的規範性和可靠性。
• 工作流自動化：實現開發流程的自動化，提高開發效率。

📦 安裝指南

安裝依賴庫

pip install mcp-agile

克隆倉庫

git clone https://github.com/yourusername/mcp-agile-flow.git
cd mcp-agile-flow

創建虛擬環境並激活

python -m venv .venv
source .venv/bin/activate  # Windows 用戶請使用：.venv\Scripts\activate

安裝開發依賴

pip install -e ".[dev]"

運行測試

pytest

💻 使用示例

基礎用法

from mcp_agile import process_natural_language

# 遷移配置示例：
result = process_natural_language("將 MCP 配置遷移到 claude-desktop")

# 獲取項目設置：
result = process_natural_language("顯示項目設置")

高級用法

# 高級場景說明：可以根據具體需求，對自然語言指令進行更復雜的處理。
from mcp_agile import process_natural_language

# 示例：處理更復雜的自然語言指令
result = process_natural_language("將 MCP 配置遷移到 claude-desktop，並更新項目版本號為 1.2.3")

📚 詳細文檔

MCP 客戶端配置

項目的配置文件需要更新到最新版本。舊版配置示例如下：

[project]
name = 項目名稱
version = 版本號
description = 項目描述

[repository]
url = https://github.com/username/repo.git
type = git

工具列表

• process-natural-language：解析自然語言指令。
• migrate-config：遷移配置文件。
• init-project：初始化新項目。

自然語言命令

系統支持通過日常語言進行操作，例如：

• 遷移配置："將 MCP 配置遷移到 claude-desktop"
• 初始化項目："為 windsurf 初始化項目規則"
• 獲取設置："顯示項目設置"

開發指南

環境搭建

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
   

常用命令

make test             # 執行所有測試
make coverage         # 生成覆蓋率報告

📄 許可證

本項目遵循 MIT 協議，具體內容詳見 LICENSE 文件。