# Hivelore MCP server

> Enforces repo-specific context policies and prevents AI coding agents from repeating documented team mistakes through deterministic gates.

- Repository: https://github.com/Doucs91/hivelore
- Page: https://hostedmcp.org/servers/doucs91/hivelore
- Transport: stdio
- Stars: 5
- License: Apache-2.0
- Latest version: 0.53.1

## Install

### Claude Code

```sh
claude mcp add hivelore -- npx -y @hivelore/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "hivelore": {
      "command": "npx",
      "args": [
        "-y",
        "@hivelore/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "hivelore": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hivelore/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"hivelore","type":"stdio","command":"npx","args":["-y","@hivelore/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "hivelore": {
      "command": "npx",
      "args": [
        "-y",
        "@hivelore/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add hivelore -- npx -y @hivelore/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.hivelore]
command = "npx"
args = ["-y", "@hivelore/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user hivelore npx -- -y @hivelore/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "hivelore": {
      "command": "npx",
      "args": [
        "-y",
        "@hivelore/mcp"
      ]
    }
  }
}
```

## Tools (16)

- `get_briefing`
- `mem_get`
- `mem_save`
- `mem_update`
- `mem_tried`
- `propose_sensor`
- `pre_commit_check`
- `report_friction`
- `mem_search`
- `mem_relevant_to`
- `mem_feedback`
- `mem_verify`
- `code_map`
- `code_search`
- `scaffold_test`
- `mem_session_end`

## FAQ

### What is Hivelore's primary function?

It acts as an enforcement layer for AI coding agents, providing them with team-specific knowledge and blocking commits that reintroduce previously documented mistakes.

### How does Hivelore provide context to AI agents?

Agents can use the `get_briefing` MCP call to receive small default context along with deeper breadcrumbs ranked by task relevance.

### Does Hivelore replace existing testing tools like unit tests or linters?

No, it is designed to complement them by making repo-specific knowledge available and enforceable that those tools cannot infer.

### Can Hivelore run custom test commands to validate changes?

Yes, through command sensors, Hivelore can execute your existing test or invariant scripts when a diff touches specific paths.
