# CodeOracle MCP server

> Provides a self-hosted memory layer for coding agents to perform hybrid codebase searches and retrieve architectural decision history with citations.

- Repository: https://github.com/Jassu78/CodeOracle
- Page: https://hostedmcp.org/servers/jassu78/codeoracle
- Transport: —
- Stars: 7
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CODEORACLE_REPO_ID` | no | no |  |

## FAQ

### Is my code sent to a cloud provider?

Not by default. You can run the entire stack locally using Ollama for embeddings and chat, ensuring source code and PR text never leave your network.

### How does CodeOracle handle decision memory?

It mines structured 'why' information from git and PR history, providing mandatory source URLs and alternatives considered to prevent hallucinations.

### Can I use this with Cursor or Claude Code?

Yes, you can plug it into Cursor, Claude Code, or any MCP client by connecting via stdio or Streamable HTTP.

### Does it replace Cursor's indexing?

No, it is designed to work alongside it, focusing on durable team memory and cited architectural decisions rather than just quick file lookups.