Pensieve MCP Server

A MCP (Model Context Protocol) server that enables conversation history sharing between ChatGPT and Claude with multi-user support and cloud deployment.

Features

• Multi-user Support: Each user has their own isolated conversation space
• Authentication: Secure JWT-based authentication
• Cloud Deployment: Deploy to Azure Container Apps
• Save Conversations: Store conversation history securely
• Load Conversations: Retrieve saved conversations by ID
• List Conversations: View all saved conversations
• Search Conversations: Search conversation content by keywords
• Append to Conversations: Add new messages to existing conversations

Installation

1. Clone the repository:

git clone <repository-url>
cd pensieve-mcp

2. Install dependencies:

uv pip install -e .

Usage in Claude

1. Open Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the following configuration:

{
  "mcpServers": {
    "pensieve-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server.server"],
      "cwd": "/path/to/pensieve-mcp"
    }
  }
}

3. Restart Claude Desktop

Usage Examples

Save Conversation

Use the save_conversation tool to save the current conversation. You can add metadata like title or tags.

Load Conversation

Use the load_conversation tool to retrieve a previous conversation by its ID.

Search Conversations

Use the search_conversations tool to find conversations containing specific keywords.

Architecture

Local Mode

Conversation data is stored as JSON files in the ~/.pensieve-mcp/conversations/ directory.

Cloud Mode (Azure)

• API Server: FastAPI backend deployed on Azure Container Apps
• Database: Azure Cosmos DB (MongoDB API)
• Authentication: JWT-based user authentication
• MCP Client: Connects to the cloud API

Azure Deployment

1. Prerequisites:

   • Azure CLI installed and logged in
   • Docker installed

2. Deploy to Azure:

   cd deploy
   ./deploy-azure.sh

3. Configure MCP client: Set the API URL in your environment:

   export PENSIEVE_API_URL="https://your-api-url.azurecontainerapps.io"

Using with Authentication

1. Register a new account:

   Use the 'register' tool with your email and password
   

2. Login:

   Use the 'login' tool with your credentials
   

3. Your token will be automatically saved for subsequent requests.