file-mcp

AI 可调用的 MCP 文件服务，支持读写：

• TXT/MD/HTML/XML/YAML
• JSON
• CSV
• PPT (.pptx)
• DOCX
• PDF
• Excel (.xlsx/.xls)

安装

npm install
npm run build

运行

npm run dev
# 或
npm start

Tools

• read_text_file(file_path)（.txt/.md/.markdown/.html/.htm/.xml/.yaml/.yml）
• write_text_file(file_path, content)（同上）
• read_json_file(file_path)（.json）
• write_json_file(file_path, data)（.json）
• read_csv_file(file_path)（.csv）
• write_csv_file(file_path, data)（.csv）
• read_pptx(file_path)（.pptx）
• write_pptx(file_path, content)（.pptx，使用 --- 分隔多页）
• read_docx(file_path)
• write_docx(file_path, content)
• read_pdf(file_path)
• write_pdf(file_path, content)
• read_excel(file_path)
• write_excel(file_path, data, sheet_name?)

Cursor MCP 配置

{
  "mcpServers": {
    "file-mcp": {
      "command": "npx",
      "args": ["tsx", "/Users/mac/Documents/WorkCodeSpace/File-MCP/src/index.ts"]
    }
  }
}

路径规则

• 绝对路径：直接使用
• 相对路径：默认自动按当前 Cursor 打开的工作区解析
• 如有特殊需求，仍可用 MCP_DEFAULT_ROOT 强制覆盖默认根目录

参考

• https://github.com/modelcontextprotocol/typescript-sdk
• https://www.npmjs.com/package/@modelcontextprotocol/sdk?activeTab=readme