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
• 贡献者：[贡献者名单]

🙏 致谢

感谢所有为这个项目做出贡献的人！