MCP 服务器工厂

一个基于 Java 的模型上下文协议 (MCP) 服务器，旨在帮助理解和构建其他 MCP 服务器。

项目概述

本项目既是学习工具，也是构建 MCP 服务器的指南。它专注于提供：

1. MCP 组件的理解：

   • 工具（执行操作的可执行函数）
   • 资源（提供信息的数据源）
   • 提示（生成响应的结构化模板）

2. 构建 MCP 服务器的模板和最佳实践

特性

1. 工具部分：

   • explain_concept - 提供 MCP 概念（工具、资源、提示、服务器、客户端）的详细解释
   • 任务计划器工具：
     • code_cleanup_planner - 生成代码清理目标的任务计划
     • feature_implementation_planner - 生成功能实现目标的任务计划
     • general_task_planner - 生成通用目标的任务计划
     • local_mcp_deployment_planner - 生成用于部署本地 MCP 服务器的任务计划，包含关键的清理和测试步骤，并在失败时中止部署

2. 资源部分：

   • mcp://factory/documentation/{topic} - 关于 MCP 主题的文档（入门、最佳实践、故障排除）

3. 提示部分：

   • tool_implementation_guide - 以不同语言实现 MCP 工具的逐步指南

架构

MCP 服务器工厂使用以下技术构建：

• Java with Spring Framework (非 Spring Boot)
• log4j2 用于日志记录实现
• Maven 用于构建管理

遵循以下设计原则：

• KISS (Keep It Simple, Stupid)（保持简单，傻瓜化）
• DRY (Don't Repeat Yourself)（不要重复自己）
• YAGNI (You Aren't Gonna Need It)（你不需要它）
• SOLID (Single responsibility, Open-closed, Liskov substitution, Interface segregation, Dependency inversion)（单一职责、开闭原则、里氏替换原则、接口隔离原则、依赖倒置原则）

项目结构

• src/main/java/user/jakecarr/ - 主要源代码

  • .../config/ - Spring 配置
  • .../main/ - 包含 main 方法的类
  • .../model/ - 领域模型和接口
  • .../model/impl/ - MCP 组件的实现
  • .../service/ - 业务逻辑和服务

• docs/api/ - API 文档

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

代码质量

代码库遵循高质量标准：

• 结构良好的代码，具有清晰的关注点分离
• 全面的文档，所有类和方法都有 Javadoc 注释
• 模块化设计，具有抽象基类和接口
• 一致的错误处理，具有适当的日志记录
• 可维护的架构，具有提取的方法和辅助函数
• 整洁的代码实践，包括：
  • 描述性的命名约定
  • 单一职责原则
  • DRY (Don't Repeat Yourself)（不要重复自己）原则
  • 适当的封装

构建和运行

前提条件

• 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.jar)

构建项目

# 克隆仓库
git clone https://github.com/yourusername/mcp-server-factory.git
cd mcp-server-factory

# 构建项目
mvn clean package

运行服务器

# 运行服务器
java -jar target/mcp-server-factory-1.0-SNAPSHOT-jar-with-dependencies.jar

运行测试

# 运行测试
mvn test

开发指南

• 核心业务逻辑不得依赖 Spring
• Spring 注解仅在 config 包中使用
• src/main/java 中没有 mocks
• 没有递归
• 测试应包含超时

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 进行更改
4. 运行测试
5. 提交 pull request

许可证

本项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。