JinDaGe - custom-MCP-server MCP Details

article

README

🚀 自动化开发代理的 MCP 服务器

这个 MCP（消息控制协议）服务器是一个强大的平台，允许不同的 AI（如 Claude）充当自主开发代理，实现从构思到最终测试整个软件开发过程的自动化，极大提升开发效率。

🚀 快速开始

要运行 MCP 服务器，请按照以下步骤操作：

确保您已安装 Java 和 Maven。
克隆此仓库到本地开发环境中。
在终端中导航到项目根目录，然后执行 mvn clean install 进行构建。
构建完成后，在 .idea 目录下找到运行配置，启动 MCP 服务器。

✨ 主要特性

主要目标

该服务器的主要目标是让 AI 能够自主开发软件，执行以下任务：

项目结构创建
需求文件生成
代码开发
测试实现
版本控制管理
以及其他任何与软件开发相关的任务

主要功能

服务器提供以下功能：

读取和写入文件
发出网络请求
连接和查询 MySQL 数据库
执行系统命令
管理 Git 仓库
以及其他更多功能...

📦 安装指南

要求

Java 17 或更高版本
Maven 3.6 或更高版本
MySQL 服务器（可选，仅在计划使用数据库功能时）
Git（用于版本控制功能）

📚 详细文档

项目结构

src/main/java/com/claude/mcp/
├── MCPServer.java           # 主服务程序，协调所有服务
├── model/
│   └── Message.java        # 消息模型，用于通信
└── service/
    ├── FileService.java    # 文件操作服务
    ├── DatabaseService.java # 数据库操作服务
    ├── NetworkService.java  # 网络操作服务
    ├── GitService.java      # Git 操作服务
    └── CommandService.java  # 系统命令执行服务

消息格式

消息以 JSON 格式交换，具有以下结构：

{
    "type": "MESSAGE_TYPE",
    "content": "可选内容",
    "parameters": {
        // 根据消息类型的具体参数
    }
}

消息类型

FILE_READ

{
    "type": "FILE_READ",
    "parameters": {
        "filePath": "/path/to/file.txt"
    }
}

FILE_WRITE

{
    "type": "FILE_WRITE",
    "parameters": {
        "filePath": "/path/to/file.txt",
        "content": "要写入的内容"
    }
}

NETWORK_REQUEST

{
    "type": "NETWORK_REQUEST",
    "parameters": {
        "url": "https://api.example.com",
        "method": "GET",
        "body": "{}"  // 可选，仅用于 POST
    }
}

DATABASE_QUERY

{
    "type": "DATABASE_QUERY",
    "parameters": {
        "connectionId": "conn1",
        "query": "SELECT * FROM table WHERE id = ?",
        "queryParams": [1]
    }
}

GIT_COMMAND

{
    "type": "GIT_COMMAND",
    "parameters": {
        "command": "commit",
        "args": ["-m", "提交信息"]
    }
}

SYSTEM_COMMAND

{
    "type": "SYSTEM_COMMAND",
    "parameters": {
        "command": "ls"
    }
}

🔧 技术细节

安全注意事项

权限管理：始终以最小权限原则运行服务器进程，避免不必要的安全风险。
认证与授权：建议在生产环境中启用身份验证和访问控制机制，确保只有经过授权的用户才能连接到服务器。
数据加密：对于敏感操作（如数据库查询），请确保传输的数据是加密的，以防止中间人攻击。

性能优化

资源监控：定期监控服务器资源使用情况（CPU、内存、磁盘空间等），及时处理性能瓶颈。
日志记录：启用详细的日志记录功能，以便在出现问题时快速定位和解决。
连接池管理：合理配置数据库连接池参数，优化资源利用率。

贡献指南

如果希望为 MCP 服务器项目做出贡献，请按照以下步骤操作：

Fork 此仓库到您的 GitHub 账户。
在本地克隆 forked 仓库。
创建新的功能分支（例如 feature/new-message-type）。
提交更改并推送到远程仓库。
创建 Pull Request 到原始仓库的主分支。

开发指南

代码规范：请遵循 Google 的 Java 编码规范，确保代码风格一致。
单元测试：为新功能添加相应的单元测试，保证代码质量。
文档更新：如果您的更改影响到 API 或功能，请相应更新项目文档。

问题报告

如果您在使用 MCP 服务器过程中遇到任何问题或有改进建议，请通过以下方式提交：

提交 Issue 到此仓库的问题跟踪板。
发送邮件至 project.maintainer@example.com

📄 许可证

该项目在 MIT 许可证下许可 - 有关详细信息，请参阅 LICENSE 文件。

感谢您对 MCP 服务器项目的关注与支持！希望该项目能为您的软件开发工作带来便利。

custom-MCP-server