### 1、MCP Inspector

使用 MCP Inspector 时，端点使用注意：

* mcp 端点，必须是 `/mcp`
* sse 端点，必须是 `/sse`
* message 端点，必须是 `/message`

SSE 示例：

```java
import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.SSE, mcpEndpoint = "/sse", messageEndpoint = "/message")
public class McpServerTool2 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}
```

STREAMABLE 示例：


```java
import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
public class McpServerTool2 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}
```

### 2、Cherry Studio

如果 tool 描述有 `outputSchema` 输出，（暂时）则会不兼容。


```java
import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.SSE, mcpEndpoint = "/sse", enableOutputSchema = false)
public class McpServerTool2 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}
```

// enableOutputSchema 属性，v3.3.3 后支持


### 3、Spring Mcp Client

（可能）不支持 sse 心跳包。需要关闭心跳机制（heartbeatInterval 置为空）

```java
import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.SSE, mcpEndpoint = "/sse", heartbeatInterval = "")
public class McpServerTool2 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}
```