MCP Server Factory

🚀 MCP 服務器工廠

本項目是一個基於 Java 的 Model Context Protocol (MCP) 服務器，旨在幫助開發者理解 MCP 協議，併為構建其他 MCP 服務器提供參考和指導。

🚀 快速開始

先決條件

• Java 21 或更高版本
• Maven 3.6 或更高版本
• MCP Java SDK 0.8.1（位於 C:/Users/jayes/vscode/java-sdk-0.8.1/java-sdk-0.8.1）

構建

運行以下命令構建項目：

mvn clean package

運行

要運行 MCP 服務器，請執行以下命令：

mvn spring-boot:run

✨ 主要特性

工具部分

• explain_concept - 提供對 MCP 概念（工具、資源、提示、服務器、客戶端）的詳細解釋
• 任務計劃工具：
  • code_cleanup_planner - 為代碼清理目標生成任務計劃
  • feature_implementation_planner - 為功能實現目標生成任務計劃
  • general_task_planner - 為一般目標生成任務計劃
  • local_mcp_deployment_planner - 為部署本地 MCP 服務器生成任務計劃，包含關鍵清理和測試步驟，在失敗時終止部署

資源部分

• mcp://factory/documentation/{topic} - 關於 MCP 主題的文檔（入門指南、最佳實踐、故障排除）

提示部分

• tool_implementation_guide - 實現 MCP 工具的不同語言分步指南

🔧 技術細節

架構

MCP 服務器工廠使用以下技術構建：

• Java，基於 Spring 框架（非 Spring Boot）
• log4j2 用於日誌實現
• Maven 用於構建管理

遵循的設計原則：

• KISS（保持簡單愚蠢）
• DRY（不要重複自己）
• YAGNI（你不會需要它）
• SOLID（單一職責、開放封閉、里氏替換、接口隔離、依賴倒置）

項目結構

• src/main/java/user/jakecarr/ - 主源代碼

  • .../config/ - Spring 配置
  • .../main/ - 包含主方法的類
  • .../model/ - 域模型和接口
  • .../model/impl/ - MCP 組件實現
  • .../service/ - 業務邏輯和服務

• docs/api/ - API 文檔

  • prompts.md - 支持提示的文檔
  • resources.md - 支持資源的文檔
  • tools.md - 支持工具的文檔

代碼質量

代碼庫遵循高標準：

• 結構良好的代碼，關注點分離明確
• 全面的文檔，所有類和方法都有 Javadoc 註釋
• 模塊化設計，使用抽象基礎類和接口
• 一致的錯誤處理，包含適當的日誌記錄
• 可維護的架構，提取方法和輔助函數
• 清潔代碼實踐 包括：
  • 描述性命名約定
  • 單一職責原則
  • DRY（不要重複自己）原則
  • 合理封裝

📚 詳細文檔

該項目既是一個學習工具，也是一個構建 MCP 服務器的指南。它專注於提供以下內容：

1. 對 MCP 組件的理解：

   • 工具（執行特定功能的動作函數）
   • 資源（提供信息的數據源）
   • 提示（生成響應的結構化模板）

2. 模板和最佳實踐 用於構建 MCP 服務器

📄 許可證

[此處應包含項目的許可證信息，例如 Apache 2.0 或 MIT 許可證。]

👨‍💻 開發人員

• 作者：傑克卡（Jake C.）
• 郵箱：jakec@example.com
• 貢獻者：[貢獻者名單]

🙏 致謝

感謝所有為這個項目做出貢獻的人！