{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xxjetspsjb6q","handle":"free-mcp-excel","url":"https://wellknown.network/agents/free-mcp-excel","links":{"self":"https://wellknown.network/agents/free-mcp-excel/record.json","html":"https://wellknown.network/agents/free-mcp-excel","markdown":"https://wellknown.network/agents/free-mcp-excel/record.md","api":"https://wellknown.network/api/v1/agents/free-mcp-excel","status":"https://wellknown.network/api/v1/agents/free-mcp-excel/status","claim":"https://wellknown.network/agents/free-mcp-excel/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/free-mcp-excel/claim.json","badge":"https://wellknown.network/agents/free-mcp-excel/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/free-mcp-excel/history","tools":"https://wellknown.network/api/v1/agents/free-mcp-excel/tools"},"ard":{"identifier":"urn:air::server:free-mcp-excel","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"free-mcp-excel","summary":"本地Excel MCP服务，提供Excel文件解析能力","description":"# Excel MCP Server\n\n本地Excel MCP（Model Context Protocol）服务，提供轻量、开箱即用的Excel文件解析能力。\n\n## 特性\n\n- ✅ **纯本地运行**：通过stdio通信，无端口监听、无网络依赖\n- ✅ **多格式支持**：自动识别并兼容 `.xlsx` 和 `.xls` 两种格式\n- ✅ **灵活部署**：支持uvx自动管理依赖或pip手动安装\n- ✅ **标准化协议**：遵循MCP协议规范，兼容Claude Desktop、Cursor等AI客户端\n- ✅ **健壮性保障**：内置文件校验、格式识别、异常处理等机制\n\n## 快速开始\n\n### 环境要求\n\n- Python 3.8+\n- MCP客户端（如Claude Desktop、Cursor等）\n\n### 安装方式\n\n#### 方式一：从PyPI安装（推荐）\n\n**使用 pip 安装（推荐，自动安装所有依赖）**：\n```bash\npip install free-mcp-excel\n```\n\n这会自动安装所有必需的依赖，包括：\n- `mcp>=0.9.0` - MCP SDK\n- `openpyxl>=3.0.0` - Excel .xlsx 处理\n- `pandas>=1.5.0` - 数据处理（约11.8MB）\n- `xlrd>=2.0.0` - Excel .xls 读取\n- `xlwt>=1.3.0` - Excel .xls 写入\n- `pycel>=1.0b0` - 公式计算引擎\n\n**或使用 uvx（首次安装较慢）**：\n```bash\nuvx free-mcp-excel\n```\n\n**注意**：\n- `uvx` 首次安装需要下载约30MB依赖（pandas 11.8MB, numpy 15.6MB, networkx 1.8MB等），可能需要几分钟\n- 如果网络较慢或遇到 \"No server info found\" 错误，建议使用 `pip install` 方式\n\n#### 方式二：从源码安装\n\n```bash\n# 克隆项目\ngit clone https://gitee.com/fanzhiyu/free-mcp-excel.git\ncd free-mcp-excel\n\n# 安装依赖（自动安装所有必需库）\npip install -r requirements.txt\n\n# 或使用开发模式安装（推荐）\npip install -e .\n```\n\n#### 方式三：手动安装依赖（如果自动安装失败）\n\n如果自动安装遇到问题，可以手动安装依赖：\n\n```bash\n# 安装核心依赖\npip install mcp>=0.9.0\npip install openpyxl>=3.0.0\npip install pandas>=1.5.0\npip install xlrd>=2.0.0\npip install xlwt>=1.3.0\npip install pycel>=1.0b0\n\n# 然后安装包\npip install free-mcp-excel\n```\n\n或者一次性安装：\n```bash\npip install mcp openpyxl pandas xlrd xlwt pycel\npip install free-mcp-excel\n```\n\n### 配置MCP客户端\n\n#### Cursor IDE配置\n\n在项目根目录创建或编辑 `.cursor/mcp.json`：\n\n**推荐配置（使用 pip 安装后）**：\n```json\n{\n  \"mcpServers\": {\n    \"free-mcp-excel\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"free_mcp_excel\"]\n    }\n  }\n}\n```\n\n**或使用 uvx（首次安装较慢）**：\n```json\n{\n  \"mcpServers\": {\n    \"free-mcp-excel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"free-mcp-excel\"]\n    }\n  }\n}\n```\n\n#### Claude Desktop配置\n\n编辑配置文件（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）：\n\n**推荐配置（使用 pip 安装后）**：\n```json\n{\n  \"mcpServers\": {\n    \"free-mcp-excel\": {\n      \"command\": \"python\",\n      \"ar…","publisher":null,"homepage":"https://gitee.com/fanzhiyu/free-mcp-excel#readme","repository":"https://gitee.com/fanzhiyu/free-mcp-excel#readme","version":"0.1.3","license":"MIT","protocols":["mcp"],"tags":["mcp","excel","model-context-protocol","ai"],"pricing":null,"endpoints":[{"url":"pypi:free-mcp-excel","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"declared"}],"categories":["documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"free-mcp-excel","registry":"pypi","observedAt":"2026-10-28T01:26:40.771Z","publishedAt":"2026-01-08T03:55:47.026255Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"free-mcp-excel","url":"https://pypi.org/project/free-mcp-excel/","firstSeenAt":"2026-09-09T15:23:45.198Z","fetchedAt":"2026-10-28T01:25:35.122Z","normalizedAt":"2026-10-28T01:25:35.122Z"}]},"firstSeenAt":"2026-09-09T15:23:45.198Z","updatedAt":"2026-10-28T01:26:40.771Z"}