@usewhisper/mcp-server

Model Context Protocol server for Whisper Context API - Connect Claude Desktop to your knowledge base.

Version 0.2.0 - Now with 15 tools including SOTA Memory System, Oracle Research Mode, and Cost Optimization!

What is MCP?

The Model Context Protocol (MCP) allows Claude Desktop to connect directly to external knowledge sources and tools. This server gives Claude Desktop access to your Whisper Context projects, enabling seamless RAG-powered conversations with advanced memory and research capabilities.

Installation

npm install -g @usewhisper/mcp-server

Setup

1. Get Environment Variables

You'll need these environment variables:

DATABASE_URL=your_neon_postgres_url
OPENAI_API_KEY=your_openai_key
WHISPER_ORG_ID=your_organization_id

Get your Whisper credentials from the dashboard.

2. Configure Claude Desktop

Add to your Claude Desktop config file:

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

{
  "mcpServers": {
    "whisper-context": {
      "command": "whisper-context-mcp",
      "env": {
        "DATABASE_URL": "postgresql://user:pass@host/db",
        "OPENAI_API_KEY": "sk-...",
        "WHISPER_ORG_ID": "org_..."
      }
    }
  }
}

3. Restart Claude Desktop

After configuration, restart Claude Desktop. The MCP server will appear in the bottom-right corner.

Available Tools

Once connected, Claude Desktop gets access to these tools:

query_context

Search your knowledge base with hybrid vector+keyword search, memory inclusion, and knowledge graph traversal.

Query your docs project for "authentication flow"

add_memory

Store persistent memories (facts, preferences, decisions) across conversations.

Remember that I prefer TypeScript over JavaScript

search_memories

Recall facts and preferences from previous interactions.

What programming languages do I prefer?

list_projects

List all available context projects.

list_sources

See all data sources connected to a project (GitHub, Notion, Confluence, etc).

add_context

Add text content directly to your knowledge base.

Add this API documentation to my docs project

track_conversation

Record conversation messages for context tracking.

get_conversation

Retrieve conversation history for a session.

Usage Examples

Once configured, you can chat with Claude Desktop naturally:

You: "Query my engineering-docs project for how to deploy to production"
Claude: [Uses query_context tool to search your docs]

You: "Remember that our staging environment is at staging.example.com"
Claude: [Uses add_memory to store this fact]

You: "What projects do I have?"
Claude: [Uses list_projects to show all your context projects]

Features

• Semantic Search: Vector embeddings + BM25 hybrid search
• Conversational Memory: Persistent memories across sessions
• Knowledge Graph: Graph-based context traversal
• Auto-sync Sources: GitHub, Notion, Confluence, Slack, and 10+ more
• Direct Ingestion: Add content directly from conversations
• Session Tracking: Maintains conversation context

Architecture

The MCP server connects directly to your Whisper Context database using:

• PostgreSQL + pgvector for vector search
• OpenAI Embeddings for semantic understanding
• Stdio Transport for Claude Desktop communication

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DATABASE_URL | Yes | PostgreSQL connection string | | OPENAI_API_KEY | Yes | OpenAI API key for embeddings | | WHISPER_ORG_ID | Yes | Your Whisper organization ID |

Troubleshooting

Server not appearing in Claude Desktop

1. Check the config file path is correct
2. Verify JSON syntax is valid
3. Restart Claude Desktop completely
4. Check Claude Desktop logs: ~/Library/Logs/Claude/ (Mac) or %APPDATA%\Claude\logs\ (Windows)

Connection errors

• Verify your DATABASE_URL is correct and accessible
• Ensure your OPENAI_API_KEY is valid
• Check that WHISPER_ORG_ID matches your organization

No results from queries

• Make sure your project has data sources connected or documents ingested
• Verify the project name/slug matches exactly
• Check that sources have been synced successfully

Links

• Documentation
• MCP Protocol
• GitHub
• Website

License

MIT