# Second Brain MCP Server

MCP server to interact with your Second Brain knowledge management system from any MCP-compatible client (Claude Desktop, VS Code, etc.).

## Features

- **add_log** - Add quick notes/log entries with timestamps
- **add_document** - Create new markdown documents directly
- **upload_document** - Upload files (.md, .txt, .pdf, .json, .yaml, .csv)
- **search** - Semantic search across your knowledge base
- **chat** - Chat with AI using RAG on your documents
- **list_logs** / **get_log** - Browse daily logs
- **list_documents** - Browse vault contents
- **get_stats** - Knowledge base statistics
- **reindex** - Trigger vault reindexing

## Installation

```bash
# Clone or copy this folder to your local machine
cd second-brain-mcp

# Install dependencies
npm install

# Build
npm run build
```

## Configuration

Set environment variables:

```bash
# Required: Your Second Brain API URL
export SECOND_BRAIN_API_URL="https://2brain.coer.nl/api"

# Optional: Basic auth credentials (if using access list)
export SECOND_BRAIN_USERNAME="your-username"
export SECOND_BRAIN_PASSWORD="your-password"
```

## Usage with Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac or `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "second-brain": {
      "command": "node",
      "args": ["/path/to/second-brain-mcp/dist/index.js"],
      "env": {
        "SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api",
        "SECOND_BRAIN_USERNAME": "your-username",
        "SECOND_BRAIN_PASSWORD": "your-password"
      }
    }
  }
}
```

## Usage with VS Code (Copilot)

Add to your VS Code settings:

```json
{
  "github.copilot.chat.mcpServers": {
    "second-brain": {
      "command": "node",
      "args": ["/path/to/second-brain-mcp/dist/index.js"],
      "env": {
        "SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api"
      }
    }
  }
}
```

## Example Usage

Once configured, you can use natural language:

- "Add a note about the meeting with John today"
- "Search my knowledge base for homelab documentation"
- "What do I know about Proxmox configuration?"
- "Upload this requirements.txt file to my second brain"
- "Show me my recent logs"

## Development

```bash
# Run in development mode
npm run dev

# Build for production
npm run build
```

## License

MIT