MCP Server Bundle

The MCP Server Bundle is a comprehensive Symfony bundle designed to facilitate the creation of Message Control Protocol (MCP) servers. This bundle provides robust tools for handling JSON-RPC requests, tool management, and efficient input validation, making it an essential resource for developers implementing MCP communication.

Key Features

• MCP Tool Management: Develop and manage custom tools that can be accessed by clients via JSON-RPC requests.
• Extensible Design: Easily extend the bundle to include custom tool handlers and method handlers by registering them with the #[AsTool] and #[AsMethodHandler] attributes.
• Input Schema Validation: Ensure data integrity through schema-based deserialization, extracting input definitions directly from tool classes.
• JSON-RPC Method Support: Includes built-in JSON-RPC methods such as initialization, tool listing, and tool execution, which are automatically registered and managed.

Tools and Customization

The bundle enables the creation of versatile tools that trigger specific logic on demand. Each tool can handle varying input schemas and returns structured results wrapped in ToolResult objects for easy integration. The built-in results include types for text, images, audio, and resources, providing flexibility for diverse applications.

Example Tool Implementation

#[AsTool(name: 'create_user', description: 'Creates a new user in the system')]
class CreateUserTool
{
    public function __invoke(CreateUserSchema $createUserSchema): ToolResult
    {
        // Your logic here
        return new ToolResult([new TextToolResult('User created successfully!')]);
    }
}

Events

The MCP Server Bundle supports a set of events for additional handling, such as before and after a tool call, as well as error events, allowing for extensive logging and debugging capabilities.

Developer Experience

To facilitate the development process, the bundle includes commands for debugging tools, enabling developers to inspect registered tools and their functionalities effectively.

Contributions

Contributors are encouraged to share enhancements and bug fixes through pull requests, adhering to the coding standards of the project. The documentation offers guidelines for setting up a development environment and testing changes.

Conclusion

The MCP Server Bundle is a well-structured and accessible solution for developers looking to implement MCP server capabilities within Symfony applications. Its dynamic architecture and emphasis on validation and management streamline the development of robust server implementations.