知识图谱搜索服务

Idea Basin MCP是一个支持向量搜索、层次化组织和自动内容摄取的个人知识图谱服务,为AI助手提供知识库的搜索、浏览和保存功能。

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

使用说明

idea basin mcp

MCP服务器 Idea Basin --具有向量搜索、分层组织和自动内容摄取的语义知识图。

使Claude(以及任何兼容MCP的AI助手)能够搜索、浏览和保存到您的个人知识库中。

运作原理

flowchart LR
    subgraph client["AI Assistant"]
        Claude["Claude / Any MCP Client"]
    end

    subgraph mcp["idea-basin-mcp"]
        direction TB
        T1["search_knowledge"]
        T2["browse_nodes"]
        T3["get_node"]
        T4["save_resource"]
        T5["fetch_and_save"]
    end

    subgraph basin["Idea Basin Server :3500"]
        API["REST API"]
        Embed["Embedder"]
        Scraper["Scraper"]
    end

    subgraph storage["Storage"]
        PG[("PostgreSQL + pgvector")]
    end

    Claude -- "stdio / JSON-RPC" --> mcp
    mcp -- "HTTP" --> API
    API --> Embed
    API --> Scraper
    API --> PG

工具

工具 说明
search_knowledge 跨所有知识块的语义相似性搜索
browse_nodes 浏览知识图树结构(3层深)
get_node 检查节点及其子节点和资源
save_resource 将笔记、研究、链接、代码或想法保存到节点
fetch_and_save 获取一个URL(网页、YouTube、GitHub、arXiv、PDF)并保存

先决条件

跑步 Idea Basin 服务器(默认值: http://localhost:3500).

安装

克劳德代码

claude mcp add idea-basin -- node /path/to/idea-basin-mcp/build/index.js

或者使用自定义Basin URL:

claude mcp add idea-basin -e IDEA_BASIN_URL=http://localhost:3500 -- node /path/to/idea-basin-mcp/build/index.js

克劳德桌面版

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

{
  "mcpServers": {
    "idea-basin": {
      "command": "node",
      "args": ["/path/to/idea-basin-mcp/build/index.js"],
      "env": {
        "IDEA_BASIN_URL": "http://localhost:3500"
      }
    }
  }
}

npm(一旦发布)

npx idea-basin-mcp

配置

环境变量 默认值 描述
IDEA_BASIN_URL http://localhost:3500 Idea Basin服务器的基本URL

发展

npm install
npm run build    # TypeScript → build/
npm run dev      # Watch mode

许可证

麻省理工学院