MCP Development

Overview

Learn how to develop custom Model Context Protocol (MCP) handlers.

Development Steps

1. Create Maven Module

<project>
    <groupId>com.astrsomn</groupId>
    <artifactId>astrsomn-mcp-custom</artifactId>
    <version>0.2.0-SNAPSHOT</version>
    
    <dependencies>
        <dependency>
            <groupId>com.astrsomn</groupId>
            <artifactId>astrsomn-api-runtime</artifactId>
            <version>${astrsomn.version}</version>
        </dependency>
    </dependencies>
</project>

2. Implement McpHandler

public class CustomMcpHandler implements McpHandler {
    
    @Override
    public String getName() {
        return "custom";
    }
    
    @Override
    public void init(Map<String, Object> config) {
        // Initialize
    }
    
    @Override
    public McpResponse execute(McpRequest request) {
        // Implementation
        return McpResponse.success("");
    }
}

3. Configure SPI

Create META-INF/services/com.astrsomn.api.runtime.mcp.McpHandler:

com.astrsomn.mcp.custom.CustomMcpHandler

Related Documentation

• Interface Guide - API interface specifications
• Examples - Complete examples