About Locus MCP
Locus MCP is an MCP server published by MiguelAPerez in the Science category: mCP server for Locus — a local semantic dataspace manager powered by Ollama.
The repository has 1 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/MiguelAPerez/locus-mcpThis 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.
Tools (3)
create_spaceCreate a new dataspace
Parameters not published.
delete_spaceDelete a dataspace and all its documents
Parameters not published.
list_spacesList all dataspaces
Parameters not published.
Ask AI
Ask AI about Locus MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run 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-mcpis a GitHub Packages package, not published to the public npm registry. Usingnpx @miguelaperez/locus-mcp(withoutgithub:) will fail unless you've configured your npm registry. Usegithub:MiguelAPerez/locus-mcpinstead.
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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.