Custom MCP Server

🚀 自動化開發代理的 MCP 服務器

這個 MCP（消息控制協議）服務器是一個強大的平臺，它允許不同的 AI（如 Claude）充當自主開發代理，能夠實現從構思到最終測試整個軟件開發過程的自動化，極大地提高了軟件開發的效率和質量。

🚀 快速開始

要運行 MCP 服務器，請按照以下步驟操作：

1. 確保您已安裝 Java 和 Maven。
2. 克隆此倉庫到本地開發環境中。
3. 在終端中導航到項目根目錄，然後執行 mvn clean install 進行構建。
4. 構建完成後，在 .idea 目錄下找到運行配置，啟動 MCP 服務器。

✨ 主要特性

主要目標

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

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

主要功能

服務器提供以下功能：

• 讀取和寫入文件
• 發出網絡請求
• 連接和查詢 MySQL 數據庫
• 執行系統命令
• 管理 Git 倉庫
• 以及其他更多功能...

📦 安裝指南

要求

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

📚 詳細文檔

項目結構

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

消息格式

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

{
    "type": "MESSAGE_TYPE",
    "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": "要寫入的內容"
    }
}

3. NETWORK_REQUEST

{
    "type": "NETWORK_REQUEST",
    "parameters": {
        "url": "https://api.example.com",
        "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",
        "args": ["-m", "提交信息"]
    }
}

6. SYSTEM_COMMAND

{
    "type": "SYSTEM_COMMAND",
    "parameters": {
        "command": "ls"
    }
}

🔧 技術細節

安全注意事項

• 權限管理：始終以最小權限原則運行服務器進程，避免不必要的安全風險。
• 認證與授權：建議在生產環境中啟用身份驗證和訪問控制機制，確保只有經過授權的用戶才能連接到服務器。
• 數據加密：對於敏感操作（如數據庫查詢），請確保傳輸的數據是加密的，以防止中間人攻擊。

性能優化

• 資源監控：定期監控服務器資源使用情況（CPU、內存、磁盤空間等），及時處理性能瓶頸。
• 日誌記錄：啟用詳細的日誌記錄功能，以便在出現問題時快速定位和解決。
• 連接池管理：合理配置數據庫連接池參數，優化資源利用率。

貢獻指南

如果希望為 MCP 服務器項目做出貢獻，請按照以下步驟操作：

1. Fork 此倉庫到您的 GitHub 賬戶。
2. 在本地克隆 forked 倉庫。
3. 創建新的功能分支（例如 feature/new-message-type）。
4. 提交更改並推送到遠程倉庫。
5. 創建 Pull Request 到原始倉庫的主分支。

開發指南

• 代碼規範：請遵循 Google 的 Java 編碼規範，確保代碼風格一致。
• 單元測試：為新功能添加相應的單元測試，保證代碼質量。
• 文檔更新：如果您的更改影響到 API 或功能，請相應更新項目文檔。

問題報告

如果您在使用 MCP 服務器過程中遇到任何問題或有改進建議，請通過以下方式提交：

• 提交 Issue 到此倉庫的問題跟蹤板。
• 發送郵件至 project.maintainer@example.com

📄 許可證

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

感謝您對 MCP 服務器項目的關注與支持！希望該項目能為您的軟件開發工作帶來便利。