ODT MCP 服务器
](https://badge.fury.io/js/odt-mcp-server)  ](https://nodejs.org/) 
一个用于处理OpenDocument Text（.odt）文件的模型上下文协议（MCP）服务器。该服务器使AI助手能够读取、分析并从ODT文档中提取数据。
特点/特性
- 读取ODT文本从ODT文档中提取干净文本
- 获取元数据检索文档信息，如作者、标题、日期等。
- 列出存档内容查看ODT压缩包中包含的所有文件
- 提取原始XML访问底层XML文件（content.xml、styles.xml、meta.xml）
先决条件
- Node.js 版本18.0.0或更高版本
- npm（Node Package Manager） （随Node.js一起提供）
安装
npm install
npm run build
npm link快速入门
🚀 试用交互式演示
# Run the full-featured demo
cd examples
node demo.js
# Or test with your own ODT file
node demo.js path/to/your/file.odt作为MCP服务器
该服务器设计为可作为MCP服务器，与Claude等AI助手或其他MCP兼容客户端一起使用。
# Run the server directly
./build/index.js
# Or after npm link, run globally
odt-mcp-server可用工具
1. read_odt
从ODT文件中读取并提取干净的文本。
输入：
file_path(字符串)：ODT 文件的路径
输出： 从文档中提取干净的文本
2. get_odt_metadata
从ODT文件的meta.xml中检索元数据。
输入：
file_path(字符串)：ODT 文件的路径
输出： 包含文档元数据的JSON对象
3. list_odt_files
列出ODT存档中的所有文件。
输入：
file_path(字符串)：ODT 文件的路径
输出： 存档中的文件名列表
4. extract_odt_xml
从ODT存档中的特定文件中提取原始XML内容。
输入：
file_path(字符串)：ODT 文件的路径xml_file（字符串）：XML 文件的名称（例如，'content.xml'、'styles.xml'、'meta.xml'）
输出： 原始XML内容
MCP配置
要使用MCP客户端连接此服务器，请在您的配置中添加以下内容：
{
"mcpServers": {
"odt": {
"command": "odt-mcp-server"
}
}
}注： 跑步之后 npm link，的 odt-mcp-server 该命令将在全局范围内可用。
发展
# Build the project
npm run build
# Build in watch mode
npm run watch技术细节
- 运行时使用ES模块的Node.js
- 依赖项：
- @modelcontextprotocol/sdkMCP SDK - adm-zipZIP存档处理 - xml2jsXML 解析
- 类型定义全面支持TypeScript
关于ODT格式
OpenDocument 文本（.odt）文件是包含以下内容的 ZIP 压缩包：
content.xml文件的主要内容meta.xml元数据（作者、标题等）styles.xml格式化和样式META-INF/manifest.xml存档清单- 其他资源（图片、字体等）
这台服务器通过MCP协议提供对所有这些组件的结构化访问。
贡献；做出贡献
欢迎投稿！以下是你如何参与帮助的方式：
- 报告问题发现了一个错误或有功能需求？ 打开一个议题/问题
- 提交拉取请求克隆该仓库，进行更改，然后提交拉取请求
- 改进文档帮助使文档更加清晰、全面
- 使用ODT文件进行测试使用各种ODT文件进行测试并报告兼容性问题
开发环境设置
git clone https://github.com/PeterHeick/odt-mcp-server.git
cd odt-mcp-server
npm install
npm run build
npm run watch # For development with auto-rebuild请确保您的代码遵循现有的编码风格，并包含适当的测试。
许可证
麻省理工学院（MIT）——欢迎出于任何目的（商业或非商业）自由使用此项目。详情请参阅完整的许可文本。