🚀 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 服务器的指南。它专注于提供以下内容：
-
对 MCP 组件的理解：
- 工具（执行特定功能的动作函数）
- 资源（提供信息的数据源）
- 提示（生成响应的结构化模板）
-
模板和最佳实践 用于构建 MCP 服务器
📄 许可证
[此处应包含项目的许可证信息，例如 Apache 2.0 或 MIT 许可证。]
👨💻 开发人员
- 作者：杰克卡（Jake C.）
- 邮箱：jakec@example.com
- 贡献者：[贡献者名单]
🙏 致谢
感谢所有为这个项目做出贡献的人！