feat(init)：完成mcp-excel-server 0.0.1版本

Author: bigcoder84

.gitignore

@@ -0,0 +1,33 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

README.md

@@ -0,0 +1,48 @@
+# mcp-excel-server
+## 项目概述
+
+mcp-excel-server 是一个基于 Spring AI MCP 框架开发的项目，其主要功能是借助 MCP 协议，为大语言模型（LLM）提供对本地 Excel 文件进行读取和写入操作的能力。通过本项目，AI 能够像人类一样调用本地工具，突破静态知识库的限制，实现动态交互。
+
+## 功能特性
+- Excel 文件读取：能够读取本地 Excel 文件（支持 .xlsx 和 .xls 格式），并将内容以 JSON 格式返回。
+
+- Excel 文件写入：可以把 JSON 数据写入到指定的本地 Excel 文件中。
+与 LLM 集成：可与支持 MCP 协议的 LLM 客户端集成，如 Claude、Cursor 和 Cherry Studio 等。
+
+## 环境要求
+Java 17 及以上
+
+## 安装与配置
+
+第一步：执行下列命令打包：
+```
+mvn clean package -Dmaven.test.skip=true
+```
+
+第二步：配置MCP Server
+```json
+{
+  "mcpServers": {
+    "AUM5itYnoMcxPiU2vFa3Z": {
+      "name": "Excel操作",
+      "type": "stdio",
+      "description": "",
+      "isActive": true,
+      "command": "java",
+      "args": [
+        "-Dspring.ai.mcp.server.stdio=true",
+        "-Dspring.main.web-application-type=none",
+        "-Dfile.encoding=UTF-8",
+        "-jar",
+        "{your_path}/mcp-excel-server-0.0.1-SNAPSHOT.jar"
+      ]
+    }
+  }
+}
+```
+## 功能演示
+![](./img/2.png)
+order.xlsx：
+![](./img/1.png)
+生成的结果：
+![](./img/3.png)

img/1.png

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>cn.bigcoder.grpc.demo.mcpexcel</groupId>
+    <artifactId>mcp-excel-server</artifactId>
+    <version>0.0.1</version>
+    <name>mcp-excel-server</name>
+    <description>mcp-excel-server</description>
+    <properties>
+        <java.version>11</java.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        <spring-boot.version>3.2.5</spring-boot.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.ai</groupId>
+            <artifactId>spring-ai-mcp-server-spring-boot-starter</artifactId>
+            <version>1.0.0-M6</version>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <scope>provided</scope>
+        </dependency>
+        <!-- Apache POI for Excel processing -->
+        <dependency>
+            <groupId>org.apache.poi</groupId>
+            <artifactId>poi</artifactId>
+            <version>5.2.3</version>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.poi</groupId>
+            <artifactId>poi-ooxml</artifactId>
+            <version>5.2.3</version>
+        </dependency>
+        <dependency>
+            <groupId>com.alibaba.fastjson2</groupId>
+            <artifactId>fastjson2</artifactId>
+            <version>2.0.43</version>
+        </dependency>
+        <!-- 使用 log4j2 的适配器进行绑定 -->
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-slf4j-impl</artifactId>
+            <version>2.19.0</version>
+        </dependency>
+
+        <!-- log4j2 日志门面 -->
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-api</artifactId>
+            <version>2.19.0</version>
+        </dependency>
+
+        <!-- log4j2 日志实面 -->
+        <dependency>
+            <groupId>org.apache.logging.log4j</groupId>
+            <artifactId>log4j-core</artifactId>
+            <version>2.19.0</version>
+        </dependency>
+
+    </dependencies>
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-dependencies</artifactId>
+                <version>${spring-boot.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

img/2.png

@@ -0,0 +1,26 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver;
+
+import cn.bigcoder.mcp.excel.mcpexcelserver.servive.ExcelReadService;
+import cn.bigcoder.mcp.excel.mcpexcelserver.servive.ExcelWriteService;
+import org.springframework.ai.tool.ToolCallbackProvider;
+import org.springframework.ai.tool.method.MethodToolCallbackProvider;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.Bean;
+
+@SpringBootApplication
+public class McpExcelServerApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(McpExcelServerApplication.class, args);
+    }
+
+    @Bean
+    public ToolCallbackProvider serverTools(ExcelWriteService excelWriteService,
+            ExcelReadService excelReadService) {
+        return MethodToolCallbackProvider
+                .builder()
+                .toolObjects(excelWriteService, excelReadService)
+                .build();
+    }
+}

img/3.png

@@ -0,0 +1,29 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver.dto;
+
+import lombok.Data;
+
+/**
+ * @author: bigcoder84
+ * @date: 2025-04-12
+ **/
+@Data
+public class BaseResponse<T> {
+
+    private boolean success;
+    private String message;
+    private T data;
+
+    private BaseResponse(boolean success, String message, T data) {
+        this.success = success;
+        this.message = message;
+        this.data = data;
+    }
+
+    public static <T> BaseResponse<T> success(T data) {
+        return new BaseResponse<>(true, null, data);
+    }
+
+    public static <T> BaseResponse<T> failed(String message) {
+        return new BaseResponse<>(false, message, null);
+    }
+}

pom.xml

@@ -0,0 +1,15 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver.dto;
+
+import lombok.Data;
+import org.springframework.ai.tool.annotation.ToolParam;
+
+/**
+ * @author: bigcoder84
+ * @date: 2025-04-12
+ **/
+@Data
+public class ExcelReadRequest {
+
+    @ToolParam(description = "文件绝对路径")
+    private String filePath;
+}

src/main/java/cn/bigcoder/mcp/excel/mcpexcelserver/McpExcelServerApplication.java

@@ -0,0 +1,17 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver.dto;
+
+import java.util.List;
+import java.util.Map;
+import lombok.Builder;
+import lombok.Data;
+
+/**
+ * @author: bigcoder84
+ * @date: 2025-04-12
+ **/
+@Builder
+@Data
+public class ExcelReadResponse {
+
+    private List<Map<String, String>> dataList;
+}

src/main/java/cn/bigcoder/mcp/excel/mcpexcelserver/dto/BaseResponse.java

@@ -0,0 +1,21 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver.dto;
+
+import java.util.List;
+import java.util.Map;
+import lombok.Data;
+import org.springframework.ai.tool.annotation.ToolParam;
+
+/**
+ * @author: bigcoder84
+ * @date: 2025-04-12
+ **/
+@Data
+public class ExcelWriteRequest {
+
+    @ToolParam(description = "文件绝对路径")
+    private String filePath;
+    @ToolParam(description = "表头列表，例如[\"列1\", \"列2\", ...]")
+    private List<String> headers;
+    @ToolParam(description = "数据列表，每个元素是一个Map，键为列名，值为对应单元格的值。例如：[{\"列1\": \"值1\", \"列2\": \"值2\",...},...]")
+    private List<Map<String, String>> dataList;
+}

src/main/java/cn/bigcoder/mcp/excel/mcpexcelserver/dto/ExcelReadRequest.java

@@ -0,0 +1,17 @@
+package cn.bigcoder.mcp.excel.mcpexcelserver.dto;
+
+import lombok.Builder;
+import lombok.Data;
+import org.springframework.ai.tool.annotation.ToolParam;
+
+/**
+ * @author: bigcoder84
+ * @date: 2025-04-12
+ **/
+@Builder
+@Data
+public class ExcelWriteResponse {
+
+    @ToolParam(description = "文件绝对路径")
+    private String filePath;
+}