MCP Server Factory

MCP Server Factory

一个基于 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 Server Factory 基于以下技术构建：

• Java 和 Spring Framework（非 Spring Boot）
• 使用 log4j2 实现日志记录
• 使用 Maven 管理构建

遵循以下设计原则：

• KISS（保持简单，愚蠢）
• DRY（不要重复自己）
• YAGNI（你不会需要它）
• SOLID（单一职责、开闭原则、里氏替换、接口隔离、依赖倒置）

项目结构

• 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（不要重复自己）原则
  • 适当的封装

构建和运行

前置条件

• 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）

构建项目

# Clone the repository
git clone https://github.com/yourusername/mcp-server-factory.git
cd mcp-server-factory

# Build the project
mvn clean package

运行服务

# Run the server
java -jar target/mcp-server-factory-1.0-SNAPSHOT-jar-with-dependencies.jar

运行测试

# Run the tests
mvn test

开发指南

• 核心业务逻辑不得依赖 Spring
• Spring 注解只能用于 config 包
• src/main/java 中不得使用模拟对象
• 不得使用递归
• 测试应包含超时设置

贡献

1. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 运行测试
5. 提交拉取请求

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。