feat(mcp): Add instructions support to MCP server

Add the ability to configure instructions for MCP servers that provide
guidance to clients on how to interact with the server.

- New instructions property in McpServerProperties
- Passing instructions to the server builder in McpServerAutoConfiguration
- Updated tests to verify instructions configuration works correctly

Signed-off-by: James Ward <[email protected]>

Author: jamesward

auto-configurations/mcp/spring-ai-autoconfigure-mcp-server/src/main/java/org/springframework/ai/mcp/server/autoconfigure/McpServerAutoConfiguration.java

@@ -223,6 +223,8 @@ public McpSyncServer mcpSyncServer(McpServerTransportProvider transportProvider,
 
 		serverBuilder.capabilities(capabilitiesBuilder.build());
 
+		serverBuilder.instructions(serverProperties.getInstructions());
+
 		return serverBuilder.build();
 	}
 
@@ -322,6 +324,8 @@ public McpAsyncServer mcpAsyncServer(McpServerTransportProvider transportProvide
 
 		serverBuilder.capabilities(capabilitiesBuilder.build());
 
+		serverBuilder.instructions(serverProperties.getInstructions());
+
 		return serverBuilder.build();
 	}
 

auto-configurations/mcp/spring-ai-autoconfigure-mcp-server/src/main/java/org/springframework/ai/mcp/server/autoconfigure/McpServerProperties.java

@@ -72,6 +72,14 @@ public class McpServerProperties {
 	 */
 	private String version = "1.0.0";
 
+	/**
+	 * The instructions of the MCP server instance.
+	 * <p>
+	 * These instructions are used to provide guidance to the client on how to interact
+	 * with this server.
+	 */
+	private String instructions = null;
+
 	/**
 	 * Enable/disable notifications for resource changes. Only relevant for MCP servers
 	 * with resource capabilities.
@@ -180,6 +188,14 @@ public void setVersion(String version) {
 		this.version = version;
 	}
 
+	public String getInstructions() {
+		return this.instructions;
+	}
+
+	public void setInstructions(String instructions) {
+		this.instructions = instructions;
+	}
+
 	public boolean isResourceChangeNotification() {
 		return this.resourceChangeNotification;
 	}

auto-configurations/mcp/spring-ai-autoconfigure-mcp-server/src/test/java/org/springframework/ai/mcp/server/autoconfigure/McpServerAutoConfigurationIT.java

@@ -73,14 +73,15 @@ void defaultConfiguration() {
 	void asyncConfiguration() {
 		this.contextRunner
 			.withPropertyValues("spring.ai.mcp.server.type=ASYNC", "spring.ai.mcp.server.name=test-server",
-					"spring.ai.mcp.server.version=2.0.0")
+					"spring.ai.mcp.server.version=2.0.0", "spring.ai.mcp.server.instructions=My MCP Server")
 			.run(context -> {
 				assertThat(context).hasSingleBean(McpAsyncServer.class);
 				assertThat(context).doesNotHaveBean(McpSyncServer.class);
 
 				McpServerProperties properties = context.getBean(McpServerProperties.class);
 				assertThat(properties.getName()).isEqualTo("test-server");
 				assertThat(properties.getVersion()).isEqualTo("2.0.0");
+				assertThat(properties.getInstructions()).isEqualTo("My MCP Server");
 				assertThat(properties.getType()).isEqualTo(McpServerProperties.ServerType.ASYNC);
 			});
 	}