AI导哈

语义数据空间管理服务

Locus-MCP是一个本地语义数据空间管理器，通过Ollama提供支持，能够管理数据空间、处理文档并运行语义搜索。

  • by MiguelAPerez
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MiguelAPerez/locus-mcp

使用说明

mcp基因座

MCP服务器 轨迹 --由Ollama提供支持的本地语义数据空间管理器。

将所有Locus HTTP端点作为MCP工具公开，以便任何兼容MCP的客户端（Claude Desktop、Cursor等）都可以管理数据空间、摄取文档和运行语义搜索。

需求

  • 轨迹 本地或远程运行
  • Node.js 18+

安装

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

或者直接使用npx运行（包在GitHub上，而不是npm注册表中）：

npx github:MiguelAPerez/locus-mcp

注： @miguelaperez/locus-mcp 是一个GitHub Packages包，未发布到公共npm注册表。使用 npx @miguelaperez/locus-mcp （无 github:)除非您配置了npm注册表，否则将失败。使用 github:MiguelAPerez/locus-mcp 相反。

配置

环境变量 默认值 描述
LOCUS_URL http://localhost:8000 API库的基本URL

MCP客户端设置

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

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

游标/其他客户端

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

mcpo（HTTP代理）

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

工具

空间

工具 说明
list_spaces 列出所有数据空间
create_space 创建新的数据空间
delete_space 删除数据空间及其所有文档

文件

工具 说明
list_documents 列出数据空间中的所有文档
ingest_document 将文本引入数据空间
get_document 按ID检索文档的全文
delete_document 按ID删除文档

搜索

工具 说明
search 数据空间上的语义搜索(query, k, full)

设置和健康状况

工具 说明
health_check 检查轨迹是否可达
get_settings 获取当前Ollama URL和嵌入模型
update_settings 更新Ollama URL和/或嵌入模型

发展

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

许可证

麻省理工学院

相关 MCP