使用说明

项目简介

loom-mcp 是一个 MCP 服务器，它为 Anthropic 的 Claude 模型提供了一个名为 "Loom" 的工具。Loom 的概念类似于在一个文本树中进行探索，用户可以从一个初始文本开始，通过不断生成和选择分支，逐步构建和扩展文本内容。这个服务器允许 Claude 通过 MCP 协议调用 Loom 工具，从而实现更加灵活和创新的文本生成方式。

主要功能点

文本树初始化: 使用 'loom_init' 工具初始化文本树的根节点，可以清空之前的树。
多分支文本生成: 使用 'loom_complete' 工具基于当前选中的节点生成多个文本补全分支，每个分支成为一个新的子节点，方便用户探索不同的文本走向。
节点选择与编辑: 使用 'loom_select' 工具选择一个节点作为新的上下文焦点，并允许对节点文本进行裁剪 (trim) 或添加少量字符 (add)，以引导后续的文本生成方向。
文本路径展示: 使用 'loom_show_path' 工具展示从根节点到当前选中节点的完整文本路径，帮助用户理解当前的文本上下文。
会话管理: 使用 'loom_set_conversation' 工具初始化或恢复会话的树状态，支持跨会话保存和加载 Loom 树。
保存和加载 Loom 树: Loom 树会被自动保存，并可以通过资源管理功能在 Claude 中加载和使用。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node 包管理器)。
下载仓库代码: 从 GitHub 仓库 https://github.com/maxsloef/loom-mcp 下载代码到本地。
安装依赖: 打开命令行终端，进入仓库代码所在的目录，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要让 Claude Desktop 客户端连接到 loom-mcp 服务器，你需要修改 Claude Desktop 的配置文件 'claude_desktop_config.json'。

找到配置文件：

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

修改配置文件： 在 'claude_desktop_config.json' 文件中，找到 'mcpServers' 字段（如果没有就手动创建），然后添加 loom-mcp 服务器的配置信息。

{
  "mcpServers": {
    "loom-mcp": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 node.js
      "args": [         // 启动命令的参数
        "/path/to/loom-mcp/build/index.js" //  指向构建后的 index.js 文件路径，请替换为你的实际路径
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<your-anthropic-api-key>" // 你的 Anthropic API 密钥，请替换为你的实际密钥
      }
    }
  }
}

注意：

请将 '/path/to/loom-mcp/build/index.js' 替换为你本地 loom-mcp 仓库 'build/index.js' 文件的绝对路径。
请将 '<your-anthropic-api-key>' 替换为你从 Anthropic 获取的 API 密钥。
如果 'claude_desktop_config.json' 文件不存在，你需要先启动一次 Claude Desktop 应用，它会自动创建该文件。
修改配置文件后，需要重启 Claude Desktop 应用 才能使配置生效。

基本使用方法

启动 MCP 服务器: 按照上述配置正确配置 Claude Desktop 后，当你启动 Claude Desktop 时，loom-mcp 服务器也会随之启动。
在 Claude 中使用 Loom 工具:
- 启动与 Claude 的对话。
- 点击 Claude 消息输入框左下角的 "工具" 图标 (通常是一个扳手或工具箱的图标)。
- 如果配置正确，你应该能在工具列表中看到 "loom_init", "loom_complete" 等 Loom 工具。
- 你可以使用自然语言指示 Claude 使用 Loom 工具，例如：
  - '请使用 loom_init 工具，初始文本为 "开始创作一个故事"'
  - '请使用 loom_complete 工具生成更多分支'
  - '请使用 loom_select 工具选择节点 ID 为 xyz123'
  - '请使用 loom_show_path 工具展示当前路径'
- 也可以直接在 Claude 的提示框中输入包含工具名称和参数的指令，例如：
```
工具调用: loom_init, 参数: {"text": "探索宇宙的奥秘"}
```
- 参考 README.md 中提供的 Prompt 示例，引导 Claude 理解和使用 Loom 工具。

调试

如果遇到问题，可以使用仓库提供的 Inspector 工具进行调试：

npm run inspector

Inspector 会提供一个 URL，在浏览器中打开该 URL 可以查看调试信息。

注意事项

loom-mcp 服务器依赖 Anthropic API，请确保你拥有有效的 Anthropic API 密钥并正确配置。
服务器配置中的文件路径需要使用绝对路径。
修改配置文件后需要重启 Claude Desktop 才能生效。
Loom 工具的设计理念是鼓励探索和发散，可能需要一些引导性的 Prompt 才能让 Claude 更好地理解和利用 Loom 的功能。

关键词