使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在扩展 Claude 等 LLM 应用的功能。它允许用户将与 Claude 的对话内容保存到本地 Markdown 文件或 Apple Notes 应用中。作为一个 MCP 服务器，它可以被配置到 Claude 客户端中，从而为 Claude 提供额外的 "工具 (Tools)" 功能。

主要功能点

保存对话到 Markdown 文件: 可以将 Claude 的对话内容以 Markdown 格式保存到本地文件中，方便用户整理和归档。
创建 Apple Notes 笔记: 可以将 Claude 的对话内容直接创建为 Apple Notes 笔记，方便在 Apple 生态系统内管理和访问。支持将 Markdown 内容转换为 HTML 格式再添加到 Apple Notes，并自动添加 '#claude' 标签。

安装步骤

克隆仓库: 首先，你需要将该仓库克隆到本地：

git clone https://github.com/29decibel/record-to-markdown

安装依赖 (可选): 虽然 'server.py' 似乎没有显式依赖，但如果运行过程中出现模块缺失的错误，可能需要安装 'markdown2' 库。可以使用 pip 或 uv 进行安装，例如使用 uv：
```
uv pip install markdown2
```

服务器配置

要将此 MCP 服务器配置到 Claude 客户端，你需要编辑 Claude 的配置文件 'claude_desktop_config.json'。

配置文件路径 (示例):

~/Library/Application\ Support/Claude/claude_desktop_config.json

配置内容: 在 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下添加一个新的服务器配置。配置信息如下：

{
  "mcpServers": {
    "record-to-notes": {  // 服务器名称，可以自定义，用于在 Claude 客户端中标识
      "command": "uv",     // 启动服务器的命令，这里假设你使用 uv 运行 Python 脚本，如果直接使用 python，则改为 "python3" 或 "python"
      "args": [            // 启动服务器的参数列表
        "--directory",    // 指定工作目录
        "/FULL_PATH_TO/record-to-markdown", //  **替换为你的 'record-to-markdown' 仓库的完整路径**
        "run",            // 使用 uv run 命令运行脚本
        "server.py"       //  服务器脚本文件名
      ]
    }
  }
}

注意:

请将 '/FULL_PATH_TO/record-to-markdown' 替换为你实际克隆仓库的本地绝对路径。
'command' 和 'args' 的配置需要根据你的 Python 环境和包管理器进行调整。如果你直接使用 Python 解释器，可以将 'command' 改为 '"python3"' 或 '"python"'，并移除 '"uv"', '"--directory"', '"run"' 参数，直接将仓库路径和脚本名作为参数。

基本使用方法

配置完成后，Claude 客户端应该能够检测到名为 'record-to-notes' 的 MCP 服务器。具体的使用方式取决于 Claude 客户端如何调用 MCP 服务器提供的工具。

通常情况下，当你在 Claude 中进行对话时，可能会出现允许你调用 "工具 (Tools)" 的选项。本项目提供的服务器定义了两个工具：

'save_to_markdown': 用于将对话内容保存为 Markdown 文件。Claude 客户端可能会提供一个界面让你输入文件名，然后调用此工具保存对话。
'create_note': 用于将对话内容创建为 Apple Notes 笔记。Claude 客户端可能会提供一个界面让你输入笔记标题，然后调用此工具创建笔记。

具体如何触发和使用这些工具，需要参考 Claude 客户端的文档或界面说明。一旦工具被调用，MCP 服务器 ('server.py') 将会接收到请求并执行相应的操作，将对话内容保存到 Markdown 文件或 Apple Notes 中。

关键词