CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl/maven-org-springframework-ai--spring-ai-spring-boot-autoconfigure

Spring AI Spring Boot Auto Configuration modules providing automatic setup for AI models, vector stores, MCP, and retry capabilities

Overview
Eval results
Files

mcp-integration.mddocs/guides/

MCP Integration Guide

Step-by-step guide for integrating Model Context Protocol with Spring AI.

Basic MCP Client Integration

Step 1: Add Dependencies

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mcp-client-spring-boot-starter</artifactId>
    <version>1.1.2</version>
</dependency>

Step 2: Configure MCP Client

spring.ai.mcp.client.enabled=true
spring.ai.mcp.client.type=SYNC
spring.ai.mcp.client.stdio.connections.filesystem.command=node
spring.ai.mcp.client.stdio.connections.filesystem.args[0]=./mcp-servers/filesystem.js

Step 3: Use MCP Tools

@Service
public class McpEnabledChatService {
    private final ChatClient chatClient;
    
    public McpEnabledChatService(
            ChatClient.Builder builder,
            SyncMcpToolCallbackProvider mcpTools) {
        
        this.chatClient = builder
            .defaultFunctions(mcpTools.getToolCallbacks())
            .build();
    }
    
    public String chat(String message) {
        // AI automatically calls MCP tools as needed
        return chatClient.prompt()
            .user(message)
            .call()
            .content();
    }
}

MCP Server Integration

Step 1: Add Server Dependencies

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>
    <version>1.1.2</version>
</dependency>

Step 2: Configure MCP Server

spring.ai.mcp.server.enabled=true
spring.ai.mcp.server.type=SYNC
spring.ai.mcp.server.transport=STDIO

Step 3: Define MCP Tools

@Component
public class MyMcpTools {
    
    @McpTool(
        name = "calculate",
        description = "Perform mathematical calculations"
    )
    public double calculate(String expression) {
        // Implementation
        return eval(expression);
    }
}

Advanced MCP Integration

Multiple Transport Types

spring:
  ai:
    mcp:
      client:
        stdio:
          connections:
            local-tools:
              command: node
              args: [./local-server.js]
        sse:
          connections:
            remote-tools:
              url: https://mcp.example.com
              sse-endpoint: /sse

Custom Tool Naming

@Bean
public McpToolNamePrefixGenerator customPrefixGenerator() {
    return transportName -> transportName.toUpperCase() + "__";
}

See Detailed MCP Client API →
See Detailed MCP Server API →

Install with Tessl CLI

npx tessl i tessl/maven-org-springframework-ai--spring-ai-spring-boot-autoconfigure

docs

index.md

tile.json