Temp Notes MCP Server

🚀 Temp Notes Usage Guide

Temp Notes is a utility tool designed to save and restore context in multi - step or multi - session tasks. It's particularly useful for complex tasks that span multiple conversations.

✨ Features

• Persistent Storage: Note contents are stored locally in a file until explicitly cleared.
• Independent Sessions: Each new conversation creates a new, blank notebook to prevent data mixing.
• File Paths:
  • macOS/Linux: ~/.mcp_config/temp_notes.txt (Actual path: /Users/username/.mcp_config/temp_notes.txt)
  • Windows: C:\Users\username\.mcp_config\temp_notes.txt

📦 Installation

This section doesn't have specific installation steps other than the CLI tool installation in the appendix. So, we'll focus on the CLI installation here.

// Install the CLI tool
npm install -g mcp-temp-note-cli

💻 Usage Examples

Basic Usage

// Initialize a new note
mcp_temp_note init

// Write new text content
mcp_temp_note write "Your note content"

// Read the current note content
mcp_temp_note read

// Clear the current note content
mcp_temp_note clear

Advanced Usage

As a Task Checklist

// Store a task list
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "write_note",
  arguments: {
    content: "# 项目重构待办事项\n\n- [ ] 分析当前架构\n- [ ] 确定性能瓶颈\n- [ ] 创建新组件结构\n- [ ] 实现数据层更改\n- [ ] 更新 UI 组件\n- [ ] 编写测试用例\n- [ ] 更新文档"
  }
});

Restore Stored Information

// Restore the list in a new conversation
const result = await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "read_note",
  arguments: {}
});

// The result contains the previously stored list content

Update Task Progress

// Update note content to reflect progress
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "append_note",
  arguments: {
    content: "## 架构分析完成\n\n关键发现：\n- 当前结构存在循环依赖\n- 数据获取效率低下\n- 组件复用度低\n\n建议：实现仓库模式和组件组合",
    include_separator: true
  }
});

Clear Note Content

// Clear the note after task completion
await use_mcp_tool({
  server_name: "temp-notes",
  tool_name: "clear_note",
  arguments: {}
});

📚 Documentation

Use Cases

Complex Coding Tasks

When dealing with complex coding tasks, Temp Notes can:

• Store task checklists.
• Include detailed descriptions for each subtask.
• Record specific files to be checked.
• Track task progress across multiple conversations.

Maintain Context Across Conversations

As conversation length increases and the context window fills up, Temp Notes allows:

• Summarizing the current task state.
• Documenting completed steps and remaining work.
• Storing important information for future reference.
• Recording next steps for new conversations.

Cross - Repository Information Transfer

When working with multiple repositories or projects, Temp Notes can be used to:

• Store code snippets from one repository.
• Save file contents as reference materials.
• Document patterns or practices from one project to another.
• Create temporary documentation to connect different projects.

Collaborative Workflows

In a multi - user collaboration scenario, Temp Notes helps:

• Centralize task information storage.
• Distribute team members' work progress.
• Ensure information synchronization among all participants.

Configuration

The configuration information for the Temp Notes server is as follows:

Example Configuration

// Initialize the Temp Notes service
{
  "server_name": "temp-notes",
  "storage_path": "~/.mcp_config/",
  "encrypt_data": false
}

Error Handling

Common Errors and Solutions

• Unable to open the note file:
  • Ensure the path permissions are correct.
  • Check if the file is occupied by other processes.
• Encryption failure:
  • Ensure the encryption key is correct.
  • Check if the system supports the required encryption algorithm.
• Empty content when reading:
  • Confirm that the write operation was successful.
  • Check if there was an accidental clear operation.

Security Precautions

• Data Encryption: All stored content should be encrypted, especially in sensitive environments.
• Access Control: Limit access to the Temp Notes service to prevent unauthorized access.
• Backup Strategy: Regularly back up note files to prevent data loss.

Upgrade Guide

When upgrading from an old version to a new one, note the following:

• Check for changes in configuration parameters.
• Ensure compatibility and adjust client code if necessary.
• Back up data before performing the upgrade.

🔧 Technical Details

This section doesn't have specific technical details that meet the requirement of more than 50 words, so it's skipped.

📄 License

This section doesn't have license information, so it's skipped.

📖 Appendix

Command - Line Tool Reference

Temp Notes provides a Command - Line Interface (CLI) tool for direct manipulation of note files.

// View help information
mcp_temp_note --help

// Write content to the note
mcp_temp_note write "Your note content"

// Read the current note content
mcp_temp_note read

// Clear the note content
mcp_temp_note clear

API Documentation

Temp Notes offers a RESTful API for developers to integrate into custom applications.

Write Content

POST /notes
Content-Type: text/plain

Your note content

Read Content

GET /notes

Clear Content

DELETE /notes

📞 Contact

If you have any questions or feedback, please contact:

• Email: support@temp-notes.com
• GitHub: https://github.com/temp-notes

⚠️ Important Note

When using Temp Notes, comply with relevant laws and regulations to ensure data security and privacy protection.