Temp Notes MCP Server 使用说明

项目简介

Temp Notes MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为 AI Agent 提供一种简单有效的方式来存储和检索临时信息。它充当 Agent 的临时记忆系统，允许 Agent 存储笔记、清单、代码片段等，并在后续会话中快速访问，从而在多次对话或复杂任务中保持上下文连贯性。

主要功能点

跨会话持久化存储临时笔记：即使对话结束或 Agent 重启，笔记内容依然保留。
提供简单的 API 进行笔记操作：支持写入、读取、追加和清空笔记内容。
轻量级易集成：设计简洁，易于安装和配置，可以快速集成到现有的 MCP 客户端工作流程中。
支持复杂任务分解：允许 Agent 将复杂任务分解为多个步骤，并使用笔记记录中间状态和重要信息。

安装步骤

根据您的偏好，选择以下任一安装方式：

方式一：使用 npx (无需安装) 无需进行任何安装步骤，可以直接通过 npx 运行服务器。

方式二：使用 npm 全局安装 如果您希望全局安装 'temp-notes-mcp-server'，请运行以下命令：

npm install -g @landicefu/temp-notes-mcp-server

方式三：从源代码安装 如果您希望从源代码安装，请按照以下步骤操作：

git clone https://github.com/landicefu/temp-notes-mcp-server.git
cd temp-notes-mcp-server
npm install
npm run build

服务器配置

在您的 MCP 客户端配置中，您需要添加 Temp Notes MCP Server 的相关信息。以下是不同安装方式对应的配置示例。请注意，您只需要配置 'command' 和 'args' 字段，无需关注代码细节。

如果使用 npx 运行，请添加以下配置：

{
  "mcpServers": {
    "temp-notes": {
      "command": "npx",
      "args": ["-y", "@landicefu/temp-notes-mcp-server"],
      "disabled": false
    }
  }
}

'command': 指定启动服务器的命令为 'npx'。
'args': 指定 'npx' 的参数，'-y' 表示自动确认安装包，'@landicefu/temp-notes-mcp-server' 是要运行的 npm 包名。

如果使用 npm 全局安装，请添加以下配置：

{
  "mcpServers": {
    "temp-notes": {
      "command": "temp-notes-mcp-server",
      "disabled": false
    }
  }
}

'command': 指定启动服务器的命令为 'temp-notes-mcp-server'（全局安装后可直接通过此命令启动）。

如果从源代码安装，并假设服务器代码构建后的入口文件路径为 '/path/to/temp-notes-mcp-server/build/index.js'，请添加以下配置：

{
  "mcpServers": {
    "temp-notes": {
      "command": "node",
      "args": ["/path/to/temp-notes-mcp-server/build/index.js"],
      "disabled": false
    }
  }
}

'command': 指定使用 'node' 命令来运行 JavaScript 文件。
'args': 指定要运行的 JavaScript 文件路径 '/path/to/temp-notes-mcp-server/build/index.js'，请替换为您的实际路径。

基本使用方法

配置完成后，您可以在 MCP 客户端中使用 'use_mcp_tool' 函数来调用 Temp Notes MCP Server 提供的工具。

1. 写入笔记 (write_note): 替换当前笔记内容。

await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: { content: "这里是你要保存的笔记内容" }
});

2. 读取笔记 (read_note): 获取当前笔记的内容。

const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});
console.log(result.content); // 打印笔记内容

3. 追加笔记 (append_note): 在当前笔记末尾追加内容，默认会添加分隔符 '---'。

await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: { content: "这是要追加到笔记的新内容", include_separator: true } // include_separator 可选，默认为 true
});

4. 清空笔记 (clear_note): 清空当前笔记的内容。

await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

通过以上工具，您的 AI Agent 就可以方便地存储和检索临时信息，提升在复杂任务和跨会话场景下的表现。

关键词