{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_95jfksusxbjw","handle":"unifiles-mcp","url":"https://wellknown.network/agents/unifiles-mcp","links":{"self":"https://wellknown.network/agents/unifiles-mcp/record.json","html":"https://wellknown.network/agents/unifiles-mcp","markdown":"https://wellknown.network/agents/unifiles-mcp/record.md","api":"https://wellknown.network/api/v1/agents/unifiles-mcp","status":"https://wellknown.network/api/v1/agents/unifiles-mcp/status","claim":"https://wellknown.network/agents/unifiles-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/unifiles-mcp/claim.json","badge":"https://wellknown.network/agents/unifiles-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:unifiles-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"unifiles-mcp","summary":"MCP server for unifiles - unified file operations library. Provides Excel, PDF, Word, and SQLite file operations through Model Context Protocol.","description":"# unifiles-mcp\n\nMCP server for [unifiles](https://github.com/Asheng008/unifiles) - unified file operations library.\n\n## 简介\n\n`unifiles-mcp` 是一个基于 [MCP Python SDK](https://pypi.org/project/mcp/) 官方 SDK 构建的 Model Context Protocol (MCP) 服务器，为 AI 助手提供统一的文件操作能力。它使用官方的 `FastMCP` 高级接口，封装了 `unifiles` 库的功能，支持 Excel、PDF、Word、SQLite 等多种文件格式的读取、写入、查询和管理。\n\n## 功能特性\n\n- ✅ **统一接口**: 通过 MCP 协议提供标准化的文件操作接口\n- ✅ **多格式支持**: Excel (.xlsx, .xls), PDF (.pdf), Word (.docx), SQLite (.db, .sqlite)\n- ✅ **类型安全**: 完整的类型注解，基于 Pydantic V2\n- ✅ **异步优先**: 所有操作使用异步方式，提高性能\n- ✅ **LLM 友好**: 优化的工具设计，减少调用次数\n\n## 环境要求\n\n- **Python**: 3.10+\n- **操作系统**: Windows 10+, Linux, macOS 10.14+\n\n## 安装\n\n从源码安装（开发模式，含测试与类型检查等依赖）：\n\n```powershell\ngit clone https://github.com/Asheng008/unifiles-mcp.git\ncd unifiles-mcp\npython -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1\npip install -e \".[dev]\"\n```\n\n仅安装运行依赖：\n\n```powershell\npip install -e .\n```\n\n使用依赖锁文件安装（推荐用于生产环境）：\n\n```powershell\npip install -r requirements.txt\n```\n\n若已发布到 PyPI：\n\n```bash\npip install unifiles-mcp\n```\n\n## 快速开始\n\n### 启动服务器\n\n安装后可在终端直接运行：\n\n```bash\nunifiles-mcp\n```\n\n或从代码启动：\n\n```python\nfrom unifiles_mcp.main import mcp\n\nif __name__ == \"__main__\":\n    mcp.run()\n```\n\n### 使用 MCP 客户端连接\n\n服务器启动后，可通过 MCP 客户端连接使用。以下为常见客户端的配置方式。\n\n#### Cursor\n\n在项目或用户配置的 `.cursor/mcp.json` 中加入（使用 PyPI 已发布包，需已安装 [uv](https://docs.astral.sh/uv/)）：\n\n```json\n{\n  \"mcpServers\": {\n    \"unifiles-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"unifiles-mcp\"]\n    }\n  }\n}\n```\n\n使用本地开发环境时，可改为指定 venv 中的 Python 与模块（将 `D:\\path\\to\\unifiles-mcp` 替换为你的项目根目录）：\n\n```json\n\"unifiles-mcp\": {\n  \"command\": \"D:\\\\path\\\\to\\\\unifiles-mcp\\\\.venv\\\\Scripts\\\\python.exe\",\n  \"args\": [\"-m\", \"unifiles_mcp.main\"]\n}\n```\n\n#### Claude Desktop / 其他 MCP 客户端\n\n在客户端的 MCP 配置文件中添加上述 `command` 与 `args`（或对应客户端的等价配置），指向 `unifiles-mcp` 或 `python -m unifiles_mcp.main` 即可。具体配置路径请参考各客户端的 MCP 文档。\n\n### 使用示例\n\n#### Excel 文件操作\n\n```python\n# 1. 检查 Excel 文件结构\nresult = await excel_inspect_file(\n    file_path=\"data.xlsx\",\n    include_preview=True,\n    preview_rows=3…","publisher":null,"homepage":"https://github.com/Asheng008/unifiles-mcp","repository":"https://github.com/Asheng008/unifiles-mcp","version":"0.1.4","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","file-operations","excel","pdf","word","sqlite"],"pricing":null,"endpoints":[{"url":"pypi:unifiles-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"declared"},{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev","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":"unifiles-mcp","registry":"pypi","observedAt":"2026-09-10T14:24:46.005Z","publishedAt":"2026-03-25T09:49:13.723625Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"unifiles-mcp","url":"https://pypi.org/project/unifiles-mcp/","firstSeenAt":"2026-09-10T14:23:58.041Z","fetchedAt":"2026-09-10T14:23:58.041Z","normalizedAt":"2026-09-10T14:23:58.041Z"}]},"firstSeenAt":"2026-09-10T14:23:58.041Z","updatedAt":"2026-09-10T14:24:46.005Z"}