使用说明

项目简介

Claude Chunks 是一个 Model Context Protocol (MCP) 服务器,旨在帮助用户更有效地处理大型文档,特别针对 Anthropic 的 Claude 模型进行了优化。它通过智能地将文档分割成有意义的块,并为每个块生成摘要,从而更好地利用 Claude 的上下文窗口,提高处理长文档的效率和质量。

主要功能点

  • 智能文档分块: 能够将大型文档分解为有意义的段落或章节,而非简单的固定大小分块,更好地保持上下文连贯性。
  • 章节摘要生成: 为每个文档分块生成简洁的摘要,帮助 Claude 理解每个部分的内容,并可能用于后续的上下文检索。
  • 上下文保持: 在分块和摘要生成过程中,努力维护文档的上下文信息,确保 Claude 能够理解各个部分之间的联系。
  • Claude 优化: 特别针对 Claude 的上下文窗口限制和特性进行优化,例如输出格式可能更适合 Claude 的输入要求。

请注意,根据仓库的开发路线图,目前可能只实现了核心功能(Phase 1),例如基本 MCP 服务器设置和文档分块功能。更高级的功能仍在计划中。

安装步骤

  1. 克隆仓库: 打开终端,执行以下命令克隆 Claude Chunks 仓库到本地:

    git clone https://github.com/vetlefo/claude-chunks.git
    cd claude-chunks
  2. 安装依赖: 在仓库目录下,使用 npm 安装项目依赖:

    npm install
  3. 构建项目: 运行构建命令编译 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与计算