文档编辑服务器

一个提供多种文档格式读取和文本文件编辑功能的MCP服务器。

  • by alphatheory-ccarneiro
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 alphatheory-ccarneiro/document-edit-mcp

使用说明

文档编辑MCP服务器

提供文档编辑功能的MCP(模型上下文协议)服务器。

⚠️ 实验-早期原型

这是一个实验性的早期原型,尚未准备好投入生产使用。 API和功能可能会发生重大变化,并且可能存在缺陷或限制。使用风险自负。

特性

  • read_文档:阅读各种文档类型的内容
    • 支持的格式:PDF、Word(.doc、.docx)、Excel(.xls、.xlsx)、CSV和纯文本文件
  • write_文档:将内容写入文本文档文件(创建或覆盖)
    • 仅适用于纯文本文件
  • edit_文档:通过替换特定文本部分来编辑文本文档
    • 仅适用于纯文本文件
  • 附录_文档:将内容附加到文本文档的末尾
    • 仅适用于纯文本文件
  • 搜索文档:在任何支持的文档格式中搜索文本
  • 获取_文件_信息:获取文件元数据和支持的操作

安装

使用npx(推荐)

如果发布到npm:

npx @yourorg/document-edit-mcp

地方发展

  1. 克隆或下载此存储库
  2. 安装依赖项:
npm install
  1. 构建项目:
npm run build
  1. 全球链接(供本地npx使用):
npm link
  1. 现在,您可以将其与npx一起使用:
npx document-edit-mcp

使用Claude Desktop

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

如果发布到npm:

{
  "mcpServers": {
    "document-edit": {
      "command": "npx",
      "args": ["@yourorg/document-edit-mcp"]
    }
  }
}

如果在本地使用(在npm链接之后):

{
  "mcpServers": {
    "document-edit": {
      "command": "npx",
      "args": ["document-edit-mcp"]
    }
  }
}

使用直接路径(备选):

{
  "mcpServers": {
    "document-edit": {
      "command": "node",
      "args": ["/path/to/document-edit-mcp/dist/index.js"]
    }
  }
}

发布到npm

通过以下方式提供 npx 对于每个人:

  1. 创建一个npm帐户(如果你没有)
  2. 登录到npm:
npm login
  1. 发布包:
npm publish --access public
  1. 现在任何人都可以使用它:
npx @yourorg/document-edit-mcp

支持的文件格式

读取操作

  • PDF (.pdf)-从pdf文件中提取文本内容
  • 字 (.doc、.docx)-从Word文档中提取文本
  • Excel (.xls,.xlsx)-将电子表格转换为类似CSV的文本格式
  • CSV (.csv)-读取逗号分隔的值
  • 纯文本 (.txt、.md、.json等)-读取任何基于文本的文件

写入/编辑操作

只有纯文本文件支持写入、编辑和追加操作。二进制格式(PDF、Word、Excel)是只读的。

工具

read_文档

读取文档文件的内容。自动检测文件类型并相应地提取文本。

参数:

  • path (string):文档文件的路径

支持的格式: PDF、Word、Excel、CSV、纯文本

write_文档

将内容写入文档文件(创建或覆盖)。

参数:

  • path (string):文档文件的路径
  • content (string):要写入文件的内容

edit_文档

通过替换特定文本部分来编辑文档。

参数:

  • path (string):文档文件的路径
  • edits (array):编辑操作数组,每个操作包含:
    • oldText (string):要查找和替换的文本
    • newText (string):要替换的文本

附录_文档

将内容附加到文档末尾。

参数:

  • path (string):文档文件的路径
  • content (string):要附加的内容

搜索文档

在文档中搜索文本。

参数:

  • path (string):文档文件的路径
  • query (string):要搜索的文本
  • caseSensitive (boolean,可选):搜索是否应区分大小写(默认值:false)

发展

开发观察模式:

npm run watch

许可证

麻省理工学院