What is Local Knowledge Mcp

local-knowledge-mcp is a service based on the Model Context Protocol (MCP) that manages and provides a local knowledge base, allowing for project-specific, indexed, and dynamic storage, updating, and querying of local knowledge relevant to different workspaces.

Use cases

Use cases include retrieving relevant knowledge before addressing user tasks, summarizing experiences after task completion, and maintaining a dynamic knowledge base that evolves with ongoing projects.

How to use

To use local-knowledge-mcp, configure the MCP client with the appropriate command and arguments to run the service. You can then query, add, or update knowledge through the MCP client by following the provided usage examples.

Key features

Key features include listing all knowledge descriptions, querying knowledge details by index, adding new knowledge, and updating existing knowledge. It also supports multiple content retrieval methods such as direct content, file reading, and dynamic script generation.

Where to use

local-knowledge-mcp can be used in various fields where localized knowledge management is essential, such as software development, research, customer support, and any domain requiring contextual information retrieval.

Local Knowledge

Local Knowledge是一个基于Model Context Protocol (MCP)的服务，用于管理和提供本地知识库。

简介

本服务允许进行有项目区分地、有索引地、动态地保存、更新和查询本地知识，将不同的知识作用于不同的工作区，以便大语言模型能够访问与当前工作区有关的知识。知识以JSON格式存储，并支持多种内容获取方式：直接内容、文件读取和脚本动态生成。

功能

• 列出所有知识描述，获取相关知识索引
• 根据索引查询知识详情
• 添加新知识
• 更新已有知识

工作目标

让mcp客户端根据已解决的问题总结知识，并马上将知识作用于接下来的问题解决中。

通过描述和索引机制，降低与当前问题无关的知识对上下文窗口的污染，节约token。

安装

可以从下载页面下载不同版本的wheel文件，使用pip进行安装：

pip install local_knowledge-0.1.0-py3-none-any.whl

本地构建

# 本地构建安装包
python setup.py sdist bdist_wheel

使用方法

配置

典型的cline mcp配置

提示词示例

可以在 mcp 客户端的 rules（例如.clinerules）中添加：

每次用户有新的任务需求时，为了了解解决用户问题有哪些注意事项和可以参考的知识点，需要率先在local_knowledge mcp服务中进行查找，发现是否有需要遵循的规则或者与用户问题相关的可以利用的知识。

完成任务后：

请回忆上述任务需求，总结完成任务的过程中，遇到了哪些阻碍，有哪些值得关注、需要长期记录，以便后续解决问题时，可以遵循或者借鉴的经验或者规范。将总结的内容，使用local_knowledge mcp服务进行记录，或者更新其中已存在的相似类型的知识。

tips:

可以将“完成任务后”的规则也写进rules中，但最好添加让mcp客户端向用户进行确认的步骤，以便审核和修改保存的内容，防止存入过多无效的信息

机制

文件结构

知识库默认保存在工作目录的.knowledge文件中，以JSON格式存储。

由于每个工作目录的知识库文件是不同的，所以对于不同的工作区，可以访问不同的本地知识库

每条知识条目包含以下字段：

• index: 知识的唯一序号
• description: 知识的大体描述，用于让模型判断是否需要查询该条知识
• detail: (可选) 知识的具体内容
• detail_file: (可选) 知识内容的文件路径
• detail_script: (可选) 获取知识内容的脚本路径

字段协同工作机制

在查询知识详情时，系统会按照以下逻辑处理这些字段：

1. description字段：始终会被包含在返回结果中，作为知识的描述部分。

2. detail字段：如果存在，系统直接将其内容添加到结果中。这适用于简短且静态的知识内容。

3. detail_file字段：如果存在，系统会尝试读取指定文件的内容并添加到结果中。

   • 可以使用相对路径（相对于知识库文件目录）或绝对路径
   • 如果文件不存在或读取失败，会返回相应的错误信息

4. detail_script字段：如果存在，系统会：

   • 加载指定的Python脚本（可以是相对路径或绝对路径）
   • 调用脚本中的detail()函数
   • 将函数返回的内容添加到结果中
   • 如果脚本执行失败，会返回相应的错误信息

5. 优先级与组合：这三种内容获取方式（detail、detail_file、detail_script）不互斥，可以同时存在。系统会按顺序处理并将所有获取到的内容组合成一个完整的知识详情返回。

示例：一个知识条目可能同时包含基本说明（detail）、详细文档（detail_file）和动态生成的最新数据（detail_script）。

{
  "index": 1,
  "description": "产品A的规格说明",
  "detail": "产品A是一款高性能设备，支持...",
  "detail_file": "docs/productA_details.md",
  "detail_script": "scripts/get_latest_specs.py"
}

查询此条目时，返回的知识详情将包含：

• “产品A是一款高性能设备，支持…”（来自detail字段）
• productA_details.md文件的内容（来自detail_file字段）
• get_latest_specs.py脚本执行detail()函数返回的内容（来自detail_script字段）

MCP接口

工具

list_knowledge

列出所有知识的描述信息。

参数:

• directory: 知识文件所在的目录路径（绝对路径）

返回:
包含所有知识描述的列表。

query_knowledge

查询指定索引的知识详情。

参数:

• directory: 知识文件所在的目录路径（绝对路径）
• indices: 要查询的知识序号列表

返回:
查询到的知识详情列表。

add_knowledge

添加新的知识。

参数:

• directory: 知识文件所在的目录路径（绝对路径）
• description: 知识的描述
• detail: (可选) 知识的具体内容
• detail_file: (可选) 知识内容的文件路径
• detail_script: (可选) 获取知识内容的脚本路径

返回:
添加结果和知识索引。

update_knowledge

更新已有知识。

参数:

• directory: 知识文件所在的目录路径（绝对路径）
• index: 要更新的知识序号
• description: (可选) 更新后的知识描述
• detail: (可选) 更新后的知识内容
• detail_file: (可选) 更新后的知识文件路径
• detail_script: (可选) 更新后的知识脚本路径

返回:
更新结果。