locus-mcp

MCP server for Locus — a local semantic dataspace manager powered by Ollama.

Exposes all Locus HTTP endpoints as MCP tools so any MCP-compatible client (Claude Desktop, Cursor, etc.) can manage dataspaces, ingest documents, and run semantic search.

Requirements

• Locus running locally or remotely

• Node.js 18+

Related MCP server: qdrant-mcp

Installation

npm install -g @miguelaperez/locus-mcp --registry=https://npm.pkg.github.com

Or run directly with npx (package is on GitHub, not the npm registry):

npx github:MiguelAPerez/locus-mcp

Note: @miguelaperez/locus-mcp is a GitHub Packages package, not published to the public npm registry. Using npx @miguelaperez/locus-mcp (without github:) will fail unless you've configured your npm registry. Use github:MiguelAPerez/locus-mcp instead.

Configuration

MCP client setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "locus": {
      "command": "npx",
      "args": ["-y", "github:MiguelAPerez/locus-mcp"],
      "env": {
        "LOCUS_URL": "http://localhost:8000"
      }
    }
  }
}

Cursor / other clients

{
  "locus": {
    "command": "npx",
    "args": ["-y", "github:MiguelAPerez/locus-mcp"],
    "env": {
      "LOCUS_URL": "http://localhost:8000"
    }
  }
}

mcpo (HTTP proxy)

{
  "mcpServers": {
    "locus": {
      "command": "npx",
      "args": ["-y", "github:MiguelAPerez/locus-mcp"],
      "env": {
        "LOCUS_URL": "http://locus:8000"
      }
    }
  }
}

Tools

Spaces

Documents

Search

Settings & health

Development

npm install
npm run dev      # watch mode
npm test         # run tests
npm run build    # compile to dist/

License

MIT