使用说明
文档编辑MCP服务器
提供文档编辑功能的MCP(模型上下文协议)服务器。
⚠️ 实验-早期原型
这是一个实验性的早期原型,尚未准备好投入生产使用。 API和功能可能会发生重大变化,并且可能存在缺陷或限制。使用风险自负。
特性
- read_文档:阅读各种文档类型的内容
- 支持的格式:PDF、Word(.doc、.docx)、Excel(.xls、.xlsx)、CSV和纯文本文件
- write_文档:将内容写入文本文档文件(创建或覆盖)
- 仅适用于纯文本文件
- edit_文档:通过替换特定文本部分来编辑文本文档
- 仅适用于纯文本文件
- 附录_文档:将内容附加到文本文档的末尾
- 仅适用于纯文本文件
- 搜索文档:在任何支持的文档格式中搜索文本
- 获取_文件_信息:获取文件元数据和支持的操作
安装
使用npx(推荐)
如果发布到npm:
npx @yourorg/document-edit-mcp
地方发展
- 克隆或下载此存储库
- 安装依赖项:
npm install
- 构建项目:
npm run build
- 全球链接(供本地npx使用):
npm link
- 现在,您可以将其与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 对于每个人:
- 创建一个npm帐户(如果你没有)
- 登录到npm:
npm login
- 发布包:
npm publish --access public
- 现在任何人都可以使用它:
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
许可证
麻省理工学院
