Cursor 接入 MCP 服务完整教程（基于 solon-ai-mcp）

本教程将详细介绍如何搭建基于 solon-ai-mcp 的 MCP（Model Context Protocol）服务器，并配置 Cursor 进行对接。以本项目为实际案例，提供完整的实现步骤。

📋 项目简介

本项目是一个基于 Spring Boot + Solon AI MCP 框架的 MCP 服务器，主要提供：

• 🔍 阿里云 SLS 日志查询服务
• 🛠️ 通用工具函数（计算器、字符串处理等）
• 🌤️ 天气查询服务
• 📝 提示词管理
• 📊 资源管理

🚀 一、项目搭建与配置

1.1 依赖配置

在 pom.xml 中添加关键依赖：

<properties>
    <solon.version>3.4.0</solon.version>
    <aliyun-sls-sdk.version>1.4.0</aliyun-sls-sdk.version>
</properties>

<dependencies>
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.7.18</version>
    </dependency>
    
    <!-- Spring AOP -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-aop</artifactId>
        <version>2.7.18</version>
    </dependency>
    
    <!-- Solon AI MCP (核心依赖) -->
    <dependency>
        <groupId>org.noear</groupId>
        <artifactId>solon-ai-mcp</artifactId>
        <version>${solon.version}</version>
    </dependency>
    
    <!-- 工具库 -->
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.16</version>
    </dependency>
    
    <!-- 阿里云SLS SDK（可选，用于日志查询） -->
    <dependency>
        <groupId>com.aliyun</groupId>
        <artifactId>sls20201230</artifactId>
        <version>${aliyun-sls-sdk.version}</version>
    </dependency>
</dependencies>

1.2 应用配置

src/main/resources/application.yml：

server:
  port: 9080

spring:
  application:
    name: sls-mcp-server

# 阿里云SLS配置（可选）
aliyun:
  sls:
    access-key-id: YOUR_ACCESS_KEY_ID
    access-key-secret: YOUR_ACCESS_KEY_SECRET
    sls-prompts:
      - keyword: 广告
        endpoint: cn-beijing.log.aliyuncs.com
        project: ads-sls
        logstore: ads-center,ads-api,ads-intelligent

# 日志配置
logging:
  level:
    root: INFO
    com.anker.sls: DEBUG

src/main/resources/mcpserver.yml：

server:
  port: 9080

# MCP服务配置（可选配置项）
#mcp:
#  server:
#    enabled: true
#    timeout: 30000
#    max-connections: 100

1.3 主启动类

package com.anker.sls;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SolonAIMcpSlsServer {
    public static void main(String[] args) {
        SpringApplication.run(SolonAIMcpSlsServer.class, args);
    }
}

1.4 MCP 服务配置

McpServerConfig.java：

@Slf4j
@Configuration
public class McpServerConfig {
    @Value("${server.servlet.context-path:}")
    private String contextPath;

    @PostConstruct
    public void start() {
        log.info("启动 Solon MCP 服务");
        System.setProperty("server.contextPath", contextPath);
        Solon.start(McpServerConfig.class, new String[]{"--cfg=mcpserver.yml"});
    }

    @Bean
    public FilterRegistrationBean mcpServerFilter() {
        FilterRegistrationBean<SolonServletFilter> filter = new FilterRegistrationBean<>();
        filter.setName("SolonFilter");
        filter.addUrlPatterns("/mcp/*");
        filter.setFilter(new SolonServletFilter());
        return filter;
    }
}

🛠️ 二、创建 MCP 工具

2.1 基础工具示例

@Controller
@McpServerEndpoint(version = "1.0", sseEndpoint = "/mcp/sse/tool")
public class ToolController {
    
    @ToolMapping(description = "加法计算器，返回两个数字的和")
    public int add(@Param(description = "第一个数字") int a, 
                   @Param(description = "第二个数字") int b) {
        return a + b;
    }

    @ToolMapping(description = "字符串反转，返回反转后的字符串")
    public String reverseString(@Param(description = "要反转的字符串") String input) {
        return new StringBuilder(input).reverse().toString();
    }

    @ToolMapping(description = "获取当前时间，返回时间字符串")
    public String getCurrentTime() {
        return java.time.LocalDateTime.now().toString();
    }
}

2.2 日志查询工具示例

@Controll

... [View full README on GitHub](https://github.com/helloxmz-collab/SolonMcpSlsLogServer#readme)