Custom MCP Server

🚀 Automated Development Agent MCP Server

This MCP (Message Control Protocol) server is a platform that allows different AIs (such as Claude) to act as autonomous development agents, providing the ability to automate the entire software development process from concept to final testing.

🚀 Quick Start

Prerequisites

• Java 17 or higher
• Maven 3.6 or higher
• MySQL server (optional, only required if you plan to use database functionality)
• Git (for version control functionality)

Steps to Run

1. Ensure you have Java and Maven installed.
2. Clone this repository to your local development environment.
3. Navigate to the project root directory in the terminal and execute mvn clean install to build the project.
4. After the build is complete, find the run configuration in the .idea directory and start the MCP server.

✨ Features

Main Objectives

The primary goal of this server is to enable AI to autonomously develop software and perform the following tasks:

• Create project structures
• Generate requirement files
• Develop code
• Implement testing
• Manage version control
• And any other tasks related to software development

Key Functions

The server provides the following features:

• Read and write files
• Make network requests
• Connect to and query MySQL databases
• Execute system commands
• Manage Git repositories
• And many more...

📚 Documentation

Project Structure

src/main/java/com/claude/mcp/
├── MCPServer.java           # Main service program, coordinating all services
├── model/
│   └── Message.java        # Message model for communication
└── service/
    ├── FileService.java    # File operation service
    ├── DatabaseService.java # Database operation service
    ├── NetworkService.java  # Network operation service
    ├── GitService.java      # Git operation service
    └── CommandService.java  # System command execution service

Message Format

Messages are exchanged in JSON format with the following structure:

{
    "type": "MESSAGE_TYPE",
    "content": "Optional content",
    "parameters": {
        // Specific parameters based on the message type
    }
}

Message Types

1. FILE_READ

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

2. FILE_WRITE

{
    "type": "FILE_WRITE",
    "parameters": {
        "filePath": "/path/to/file.txt",
        "content": "Content to write"
    }
}

3. NETWORK_REQUEST

{
    "type": "NETWORK_REQUEST",
    "parameters": {
        "url": "https://api.example.com",
        "method": "GET",
        "body": "{}"  // Optional, only for POST
    }
}

4. DATABASE_QUERY

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

5. GIT_COMMAND

{
    "type": "GIT_COMMAND",
    "parameters": {
        "command": "commit",
        "args": ["-m", "Commit message"]
    }
}

6. SYSTEM_COMMAND

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Important Note

• Permission Management: Always run the server process with the principle of least privilege to avoid unnecessary security risks.
• Authentication and Authorization: It is recommended to enable authentication and access control mechanisms in the production environment to ensure that only authorized users can connect to the server.
• Data Encryption: For sensitive operations (such as database queries), ensure that the transmitted data is encrypted to prevent man-in-the-middle attacks.

💡 Usage Tip

• Resource Monitoring: Regularly monitor server resource usage (CPU, memory, disk space, etc.) and address performance bottlenecks promptly.
• Logging: Enable detailed logging to quickly locate and resolve issues when they occur.
• Connection Pool Management: Reasonably configure database connection pool parameters to optimize resource utilization.

📋 Contribution Guidelines

If you wish to contribute to the MCP server project, please follow these steps:

1. Fork this repository to your GitHub account.
2. Clone the forked repository locally.
3. Create a new feature branch (e.g., feature/new-message-type).
4. Commit your changes and push them to the remote repository.
5. Create a Pull Request to the main branch of the original repository.

Development Guidelines

• Code Style: Please follow Google's Java coding standards to ensure consistent code style.
• Unit Testing: Add corresponding unit tests for new features to ensure code quality.
• Documentation Update: If your changes affect the API or functionality, please update the project documentation accordingly.

📋 Issue Reporting

If you encounter any issues or have suggestions for improvement while using the MCP server, please submit them in the following ways:

• Submit an Issue to the issue tracker of this repository.
• Send an email to project.maintainer@example.com

Thank you for your attention and support for the MCP server project! We hope this project will bring convenience to your software development work.