🚀 FastExcel MCP 服务器
FastExcel MCP 服务器是一个用 Java 实现的 MCP（模型上下文协议）服务器，主要用于处理 Excel 操作，并且支持标准头列关系，能有效提升 Excel 数据处理的效率。
🚀 快速开始
若要在项目中使用此服务器，需满足以下环境要求并执行相应的构建命令。
环境要求
- JDK 8 或更高版本
- Maven 3.6 或更高版本
构建命令
执行以下 Maven 命令：
mvn clean install
✨ 主要特性
- 可读取 Excel 文件（XLSX、XLS、CSV）的表头和数据行。
- 能验证输入路径是否符合配置的工作空间。
- 支持多张表格和自定义表头行。
- 可获取 Excel 文件中的总数据行数（不包括表头）。
- 内置性能缓存功能，实现更快的重复访问。
⚠️ 重要提示
该服务器仅允许在
env: MCP_WORKSPACES配置的工作目录内执行操作。
📚 详细文档
API
工具
-
get_total_rows_number (带缓存支持)
- 功能：获取 Excel 文件中数据行的总数（不包括表头行）。
- 输入：
excelPath(字符串)：Excel 文件的绝对路径或相对路径。headRowNumber(整数)：表头所在的行号（1 基数索引）。sheetName(字符串，可选)：要读取的工作表名称。如果为空，则默认使用第一张工作表。
- 返回：数据行的总数，以整数形式返回。
-
get_sheet_names (带缓存支持)
- 功能：检索 Excel 文件中的所有工作表名称及其索引。
- 输入：
excelPath(字符串)：Excel 文件的绝对路径或相对路径。
- 返回：一个包含工作表编号和名称的对象列表。
-
read_head_spec (带缓存支持)
- 功能：解析并返回 Excel 文件中的头信息。
- 输入：
excelPath(字符串)：Excel 文件的绝对路径或相对路径。headRowNumber(整数)：表头所在的行号（1 基数索引）。sheetName(字符串，可选)：要读取的工作表名称。如果为空，则默认使用第一张工作表。
- 返回：一个按顺序排列的列索引和标题对象列表。
-
read_rows_spec (带缓存支持)
- 功能：解析并返回与头关联的数据行信息。
- 输入：
excelPath(字符串)：Excel 文件的绝对路径或相对路径。headRowNumber(整数)：表头所在的行号（1 基数索引）。readRowNumbers(整数，可选)：要读取的数据行数（不包括表头）。如果为 null，则读取所有数据行。sheetName(字符串，可选)：要读取的工作表名称。如果为空，则默认使用第一张工作表。
- 返回：一个包含行数据及其标题链接的对象列表。
-
cache_clear
- 功能：从内存中清除所有缓存的 Excel 文件数据。
- 返回：成功清除时返回 true。
-
test_cache_available
- 功能：检查指定的 Excel 文件是否在缓存中可用。
- 输入：
excelPath(字符串)：Excel 文件的绝对路径或相对路径。
- 返回：布尔值，表示文件是否在缓存中。
💻 使用示例
与 Claude Desktop 配合使用
要在 Claude Desktop 中使用此服务器，请将以下内容添加到配置文件 claude_desktop_config.json：
{
"fastExcelMcpServer": {
"enabled": true,
"config": {
"mcpEndpoint": "http://localhost:8080", // MCP 服务的端点地址
"workSpaceRoot": "/path/to/workspace", // 工作空间根目录
"cacheExpiration": 3600, // 缓存过期时间（秒）
"maxCacheSize": 1000 // 最大缓存文件数
}
}
}
📄 许可证
该服务器遵循 Apache License 2.0 许可证。