使用说明
项目简介
Claude Chunks 是一个 Model Context Protocol (MCP) 服务器,旨在帮助用户更有效地处理大型文档,特别针对 Anthropic 的 Claude 模型进行了优化。它通过智能地将文档分割成有意义的块,并为每个块生成摘要,从而更好地利用 Claude 的上下文窗口,提高处理长文档的效率和质量。
主要功能点
- 智能文档分块: 能够将大型文档分解为有意义的段落或章节,而非简单的固定大小分块,更好地保持上下文连贯性。
- 章节摘要生成: 为每个文档分块生成简洁的摘要,帮助 Claude 理解每个部分的内容,并可能用于后续的上下文检索。
- 上下文保持: 在分块和摘要生成过程中,努力维护文档的上下文信息,确保 Claude 能够理解各个部分之间的联系。
- Claude 优化: 特别针对 Claude 的上下文窗口限制和特性进行优化,例如输出格式可能更适合 Claude 的输入要求。
请注意,根据仓库的开发路线图,目前可能只实现了核心功能(Phase 1),例如基本 MCP 服务器设置和文档分块功能。更高级的功能仍在计划中。
安装步骤
-
克隆仓库: 打开终端,执行以下命令克隆 Claude Chunks 仓库到本地:
git clone https://github.com/vetlefo/claude-chunks.git cd claude-chunks -
安装依赖: 在仓库目录下,使用 npm 安装项目依赖:
npm install -
构建项目: 运行构建命令编译 TypeScript 代码:
npm run build构建成功后,会在 'dist' 目录下生成服务器的 JavaScript 代码。
服务器配置
要将 Claude Chunks MCP 服务器与 MCP 客户端(例如 Claude Desktop)配合使用,您需要在客户端的 MCP 服务器配置中添加以下信息。以 Claude Desktop 为例,在 Claude Desktop 的配置文件中,'mcpServers' 部分添加如下配置:
{ "mcpServers": { "claude-chunks": { "command": "node", "args": ["/path/to/claude-chunks/dist/index.js"] } } }
配置参数说明:
- '"claude-chunks"': 服务器名称,可以自定义,用于在客户端中标识和引用该服务器。
- '"command"': 启动服务器的命令,这里使用 'node' 命令来执行 JavaScript 代码。
- '"args"': 启动命令的参数,是一个字符串数组。
- '"/path/to/claude-chunks/dist/index.js"': 指向 Claude Chunks 服务器入口文件 'index.js' 的路径。请务必将 '/path/to/claude-chunks' 替换为您本地 Claude Chunks 仓库的实际路径。
例如,如果您的 'claude-chunks' 仓库克隆在用户主目录下的 'Documents' 文件夹中,则 'args' 应该配置为:
"args": ["/Users/your_username/Documents/claude-chunks/dist/index.js"]
配置完成后,重启您的 MCP 客户端 (如 Claude Desktop) 使配置生效。
基本使用方法
配置完成后,您应该可以在 MCP 客户端中使用 Claude Chunks 服务器提供的工具了。根据 'README.md' 的描述,该服务器计划提供 'chunk_document' 工具。
在与 Claude 的对话中,您可以尝试调用 'chunk_document' 工具来处理文档。具体的工具调用方式取决于您的 MCP 客户端。
例如,在 Claude Desktop 中,您可能可以使用类似以下的指令来指示 Claude 使用 'chunk_document' 工具 (具体指令格式取决于 Claude Desktop 的实现和 Claude Chunks 服务器实际提供的工具接口):
@claude-chunks chunk_document <document_path>
请注意:
- 仓库 'src/index.ts' 中 'setupToolHandlers' 函数目前是空的 ('// TODO: Implement tool handlers'),这意味着 'chunk_document' 工具可能尚未完全实现或可用。 您可能需要查看仓库的后续更新或自行完成工具的具体实现。
- 当前版本可能功能有限,请关注仓库的开发路线图和更新日志,以了解最新的功能进展。
总结
Claude Chunks 提供了一个基于 MCP 协议的文档分块服务器框架,虽然目前可能处于早期开发阶段,但已经具备了 MCP 服务器的基本结构和文档处理的初步功能。通过配置并运行该服务器,您可以在支持 MCP 协议的客户端中使用其提供的文档处理能力,并有望提高 Claude 等 LLM 处理长文档的效率。
信息
分类
AI与计算