# FlowNoter MCP Server

A Model Context Protocol (MCP) server for saving conversation notes as markdown files.

## Features

- 📝 Save agent conversation history as markdown notes
- 🗂️ Automatically organizes notes in a `notes` folder
- 🧹 Filters out thinking process and tool execution details
- ⏰ Adds timestamps to each note
- 🎯 Extracts clean responses from assistant messages
- 🔧 Configurable number of conversation turns to save

## Installation

### Via npm

```bash
# Install globally
npm install -g @tricrepe/flownoter

# Or use with npx (no installation needed)
npx @tricrepe/flownoter
```

### Local Development

```bash
git clone https://github.com/tricrepe/flownoter.git
cd flownoter
npm install
npm run build
```

## Configuration

Add this to your MCP settings configuration file:

### Option 1: Using npx (Recommended)

```json
{
  "mcpServers": {
    "flownoter": {
      "command": "npx",
      "args": ["-y", "@tricrepe/flownoter"]
    }
  }
}
```

### Option 2: Global installation

```bash
npm install -g @tricrepe/flownoter
```

```json
{
  "mcpServers": {
    "flownoter": {
      "command": "flownoter"
    }
  }
}
```

### Option 3: Local development

```json
{
  "mcpServers": {
    "flownoter": {
      "command": "node",
      "args": ["/path/to/flownoter/dist/index.js"]
    }
  }
}
```

## Available Tools

### save_conversation_note

Saves recent conversation messages as a markdown note.

**Parameters:**

- `messages` (required): Array of conversation messages
  - Each message should have:
    - `role`: Either "user" or "assistant"
    - `content`: The message content
- `user_question` (required): The user's question to use as the note title
- `num_messages` (optional): Number of recent conversation turns to include (default: all messages)

**Example:**

```json
{
  "messages": [
    {
      "role": "user",
      "content": "How do I create an MCP server?"
    },
    {
      "role": "assistant",
      "content": "To create an MCP server, you need to..."
    }
  ],
  "user_question": "Creating an MCP server",
  "num_messages": 1
}
```

## Output Format

Notes are saved in the `notes/` folder with the following format:

```markdown
# [User Question]

**Created:** [ISO 8601 Timestamp]

---

## Question

[User's question]

## Answer

[Assistant's clean response without thinking process or tool calls]
```

## File Naming

Note files are named using:
- Sanitized version of the user's question (alphanumeric characters and Chinese characters only)
- Timestamp for uniqueness
- `.md` extension

Example: `Creating_an_MCP_server_1696348800000.md`

## Development

### Build

```bash
npm run build
```

### Run Locally

```bash
npm start
```

## License

ISC