How do I use Oracle MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Oracle MCP how should I handle merge conflicts in git?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Oracle MCP - AI Knowledge Management Server

"The Oracle Keeps the Human Human" - queryable via MCP

A Model Context Protocol (MCP) server for semantic search and knowledge management. Store principles, patterns, and learnings with hybrid keyword + vector search.

Installation

As Claude Code Plugin

# Via Claude Code CLI
claude plugin add laris-co/oracle-mcp

Manual Setup

# Clone and install
git clone https://github.com/laris-co/oracle-mcp
cd oracle-mcp
npm install

# Run MCP server
npm run dev

Configuration

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "oracle-mcp": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/oracle-mcp",
      "env": {
        "ORACLE_DATA_DIR": "/path/to/data"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
`ORACLE_DATA_DIR`	`~/.oracle-mcp/`	Data directory for SQLite + ChromaDB

MCP Tools

oracle_search

Hybrid search (keywords + semantic) across knowledge base.

{
  "query": "how should I handle file deletion?",
  "type": "principle",
  "mode": "hybrid",
  "limit": 5
}

mode: hybrid (default), fts (keywords only), vector (semantic only)
type: principle, pattern, learning, retro, all

oracle_consult

Get guidance on a decision based on stored principles.

{
  "decision": "Should I amend this commit?",
  "context": "I just made a commit but forgot to add a file"
}

oracle_learn

Add new patterns or learnings to knowledge base.

{
  "pattern": "Always verify before destructive operations",
  "source": "Retrospective 2025-01-15",
  "concepts": ["safety", "verification"]
}

oracle_list

Browse documents without search (pagination supported).

{
  "type": "learning",
  "limit": 10,
  "offset": 0
}

oracle_reflect

Get random wisdom for reflection.

{}

Data Storage

All data stored in ORACLE_DATA_DIR (default: ~/.oracle-mcp/):

~/.oracle-mcp/
├── oracle.db       # SQLite database (FTS5 + metadata)
├── chroma_data/    # ChromaDB vector embeddings
└── learnings/      # Markdown files from oracle_learn

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build TypeScript
npm run build

# Run production
npm start

# Run with pm2
pm2 start ecosystem.config.cjs

Architecture

Claude Code → MCP Server → SQLite (FTS5) + ChromaDB (vectors)
                               ↓
                         oracle.db + chroma_data/

Following claude-mem patterns:

Hybrid search (FTS5 keywords + vector semantic)
Graceful degradation (works without ChromaDB)
Local embeddings via ChromaDB
SQLite as source of truth

License

MIT

Created: 2025-12-29 Architecture: claude-mem inspired

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Oracle MCP