Excel文件操作服务

一个无需安装Microsoft Excel即可创建、读取和修改Excel工作簿的模型上下文协议(MCP)服务器。

  • by Aifornorms
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aifornorms/excelmcp

使用说明

Excel MCP服务器

一种模型上下文协议(MCP)服务器,允许您在不安装Microsoft Excel的情况下操作Excel文件。使用AI代理创建、读取和修改Excel工作簿。

特性

  • 📊 创建和修改Excel工作簿
  • 📝 读写数据
  • 🎨 应用格式和样式
  • 📈 创建图表和可视化
  • 🔄 管理工作表和范围

快速开始

先决条件

  • Python 3.10或更高版本

安装

  1. 克隆存储库:
git clone https://github.com/Aifornorms/ExcelMCP.git
cd ExcelMCP
  1. 使用紫外线进行安装:
python -m venv .venv
.venv/scripts/activate
pip install uv
uv pip install -e .

运行服务器

启动服务器(默认端口8000):

uv run excel-mcp-server

自定义端口(例如8080):

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run excel-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run excel-mcp-server

使用AI工具

光标IDE

  1. 将此配置添加到游标:
{
  "mcpServers": {
    "excel": {
      "url": "http://localhost:8000/sse",
      "env": {
        "EXCEL_FILES_PATH": "Excel_files"
      }
    }
  }
}
  1. Excel工具将通过您的AI助手提供。

远程托管和传输协议

此服务器使用服务器发送事件(SSE)传输协议。对于不同的用例:

  1. 与Claude Desktop一起使用(需要stdio):

    • 使用 超级网关 要将SSE转换为stdio,请执行以下操作:
  2. 托管您的MCP服务器:

环境变量

  • FASTMCP_PORT:服务器端口(默认值:8000)
  • EXCEL_FILES_PATH:Excel文件目录(默认: ./excel_files)

可用工具

服务器提供了一套全面的Excel操作工具。看 TOOLS.md 获取所有可用工具的完整文档。

许可证

MIT许可证-请参阅 许可证 了解详情。