1. Conduid
  2. Science
  3. Locus MCP
MCP server · Science

Locus MCP

· github.com/MiguelAPerez/locus-mcp

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

Unclaimed mcpself-hosted
InstallView source
34Low

Scored 5 months ago · breakdown

About Locus MCP

Locus MCP is an MCP server in the Science category: mCP server for Locus — a local semantic dataspace manager powered by Ollama. It has been installed 0 times through Conduid.

Install

Clone
git clone https://github.com/MiguelAPerez/locus-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Locus MCP

Powered by Claude · Grounded in docs

I know everything about Locus MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • ·Scoped permissionsNot checked yet.

README

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+

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

Environment variable Default Description
LOCUS_URL http://localhost:8000 Base URL of the Locus API

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

Tool Description
list_spaces List all dataspaces
create_space Create a new dataspace
delete_space Delete a dataspace and all its documents

Documents

Tool Description
list_documents List all documents in a dataspace
ingest_document Ingest text into a dataspace
get_document Retrieve full text of a document by ID
delete_document Delete a document by ID

Search

Tool Description
search Semantic search over a dataspace (query, k, full)

Settings & health

Tool Description
health_check Check if Locus is reachable
get_settings Get current Ollama URL and embedding model
update_settings Update Ollama URL and/or embedding model

Development

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

License

MIT

README mirrored from the source repository 5 months ago. The original is authoritative.

Questions

About Locus MCP

How do I install Locus MCP?

Run git clone https://github.com/MiguelAPerez/locus-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Locus MCP safe to use with an AI agent?

Its trust score is 34 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Locus MCP still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.