Autonomous Dev Agent

🚀 自主開發智能體的MCP服務器

本MCP（消息控制協議）服務器作為一個強大的平臺，支持接入不同的AI（如Claude）作為自主開發代理，具備自動化整個軟件開發生命週期的能力，從創意構思直至最終測試，極大地提升了軟件開發的效率與質量。

🚀 快速開始

要運行該項目，請按照以下步驟操作：

1. 確保已安裝Java 17或更高版本。
2. 安裝Maven 3.6或更高版本。
3. 克隆項目倉庫：

   git clone [your-repository-url]
   

4. 在項目根目錄下運行以下命令進行編譯和運行：

   mvn clean install
   

✨ 主要特性

主要目標

該服務器的主要目標是讓AI能夠自主開發軟件，執行以下任務：

• 項目結構創建
• 需求文件生成
• 代碼開發
• 測試實現
• 版本控制管理
• 以及其他任何與軟件開發相關的任務

主要功能

該服務器提供以下能力：

• 文件讀取和寫入
• 網絡請求的發送
• MySQL數據庫的連接和查詢（可選，僅在計劃使用數據庫功能時）
• 系統命令的執行
• Git版本控制倉庫的管理
• 以及其他更多功能...

📦 安裝指南

先決條件

• Java 17或更高版本
• Maven 3.6或更高版本
• MySQL服務器（可選，僅在計劃使用數據庫功能時）
• Git（用於版本控制功能）

💻 使用示例

消息格式

消息以JSON格式交換，具有以下結構：

{
    "type": "MESSAGE_TYPE",
    "content": "optional content",  // 可選內容
    "parameters": {
        // 根據消息類型的具體參數
    }
}

消息類型

1. FILE_READ

{
    "type": "FILE_READ",
    "parameters": {
        "filePath": "/path/to/file.txt"
    }
}

2. FILE_WRITE

{
    "type": "FILE_WRITE",
    "parameters": {
        "filePath": "/path/to/file.txt",  // 文件路徑
        "content": "content to write"      // 寫入內容
    }
}

3. NETWORK_REQUEST

{
    "type": "NETWORK_REQUEST",
    "parameters": {
        "url": "https://api.example.com",  // 請求URL
        "method": "GET",                  // 請求方法
        "body": "{}"                      // 可選，僅用於POST請求
    }
}

4. DATABASE_QUERY

{
    "type": "DATABASE_QUERY",
    "parameters": {
        "connectionId": "conn1",         // 連接標識符
        "query": "SELECT * FROM table WHERE id = ?",  // 查詢語句
        "queryParams": [1]                // 查詢參數
    }
}

5. GIT_COMMAND

{
    "type": "GIT_COMMAND",
    "parameters": {
        "command": "commit",             // Git命令
        "message": "Commit message"       // 提交信息
    }
}

6. EXECUTE_COMMAND

{
    "type": "EXECUTE_COMMAND",
    "parameters": {
        "command": "ls -a"               // 要執行的系統命令
    }
}

📚 詳細文檔

項目結構

src/main/java/com/claude/mcp/
├── MCPServer.java           # 主服務程序，協調所有服務
├── model/
│   └── Message.java        # 消息模型，用於通信
└── service/
    ├── FileService.java    # 文件操作服務
    ├── DatabaseService.java # 數據庫操作服務
    ├── NetworkService.java  # 網絡操作服務
    ├── GitService.java      # Git操作服務
    └── CommandService.java  # 系統命令執行服務

文檔貢獻

如果您希望為該項目做貢獻，請遵循以下指南：

1. 提交代碼前，請確保代碼符合項目的編碼規範和風格指南。
2. 新功能請附帶相應的測試用例，並確保現有測試通過。
3. 更新文檔以反映您的更改，確保其他開發者能夠理解新功能或變更。

開始貢獻

• 克隆倉庫
• 創建功能分支：git checkout -b feature/your-feature-name
• 提交代碼並推送：git push origin feature/your-feature-name

歡迎加入我們的開發社區！

🔧 技術細節

注意事項

⚠️ 重要提示

請確保所有依賴項已正確下載。如果遇到依賴問題，請檢查Maven配置。首次運行時，可能需要安裝一些插件或工具，具體取決於項目需求。

📄 許可證

該項目在MIT許可證下授權。有關詳細信息，請參閱LICENSE文件。