Personal Knowledge MCP

关键词

知识管理语义检索图数据库向量检索嵌入提供者

使用说明（简要要点，便于快速上手）：

  • 项目简介

    • Personal Knowledge MCP 是一个面向 LLM 客户端的 MCP 服务器实现。它提供资源（Resources）管理、工具（Tools）注册与执行，以及 Prompt 模板渲染等功能，通过 JSON-RPC 与客户端通信，支持多种传输协议，能在本地自动化搭建知识管理与代码智能查询的后端服务。

  • 主要功能点

    • 资源管理与数据访问：集中管理知识源、代码片段、文档等资源，支持向量化检索与私有数据访问。
    • 工具注册与执行：LLM 可以通过 MCP 调用服务端注册的工具来执行外部功能与任务。
    • Prompt 模板定义与渲染：为不同交互场景提供可定制的提示模板，动态渲染交互流程。
    • JSON-RPC 通信：客户端通过标准的 JSON-RPC 请求与 MCP 服务器交流，收发响应与通知。
    • 会话管理与能力声明：服务器维护会话、声明自身能力、以及对不同客户端提供隔离的实例。
    • 多传输协议支持：stdio、HTTP/SSE、WebSocket 等，覆盖不同类型的客户端。
    • 安全与扩展性：Bearer Token、OIDC 认证、速率限制，以及对多实例和私有知识库的支持。
    • 集成栈与生态：ChromaDB 向量检索、FalkorDB 图数据库、私有仓库索引、嵌入提供者（OpenAI、Transformers.js、Ollama）等。

  • 安装与运行要点

    • 该仓库提供完整的服务端实现以及与之配套的嵌入、图数据库、向量存储、认证与传输组件的代码。
    • 运行通常需要本地或容器化的依赖（ChromaDB、FalkorDB、链接的向量/图数据库等），并通过 MCP 服务端入口启动服务。

  • 服务器配置（面向 MCP 客户端）

    • MCP 客户端需要配置一个 MCP 服务器条目，包含服务器名称、启动命令及参数等信息。示例描述如下，供理解配置字段含义之用（非代码块展示，便于阅读）：
      • server name: personal-knowledge
      • command: bun
      • args: ["run", "dist/index.js"]
      • env（可选）：OPENAI_API_KEY、GITHUB_PAT、FALKORDB_HOST、FALKORDB_PORT、FALKORDB_PASSWORD 等，用以选择外部提供者、私有仓库访问、以及图/向量数据库的连接信息。
    • MCP 服务器在启动后会暴露一个 JSON-RPC 接口，客户端通过该接口进行资源读取、工具调用、Prompts 获取和模板渲染等操作。

  • 基本使用方法（概览）

    • 启动：在本地或容器中按照项目的依赖要求启动 MCP 服务器，确保向量库和图数据库就绪。
    • 集成：在 Claude Code、Cursor 等客户端中添加 MCP 服务器配置项，指向上述启动命令及参数，以便客户端发现并调用 MCP 提供的工具和资源。
    • 使用场景：自然语言查询语义检索、依赖分析、架构洞察、执行外部工具、以及通过模板渲染获得定制化的对话上下文。

服务器信息

访问项目