Knowledge Base MCP

MCP文档知识

提供方 cwente25

文档知识 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个基于Markdown的个人知识库管理服务器,支持AI助手自然语言读写和搜索笔记。

一句话选型结论

按资料字段整理

Knowledge Base MCP 属于文档知识类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

知识管理Python本地部署AI辅助Markdown笔记系统搜索功能

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Knowledge Base MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cwente25上游标注的维护方 cwente25
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.2 KB
来自项目仓库与上游目录的原文,未做删改

知识库MCP服务器

用于管理基于个人标记的知识库的模型上下文协议(MCP)服务器。让像克劳德这样的人工智能助手能够自然地阅读、搜索和更新你的笔记。

概述

此MCP服务器提供对存储为带有YAML frontmatter的markdown文件的个人知识库的AI原生访问。它允许您:

  • 跨多个类别创建和组织笔记
  • 使用自然语言搜索您的知识库
  • 在人工智能的帮助下更新和维护笔记
  • 将所有数据保存为人类可读、可移植的markdown格式
  • 从Claude Desktop、Claude Code或任何兼容MCP的客户端访问您的笔记
  • 新 通过附带的web UI浏览和编辑笔记

特性

核心能力

  • 7 MCP工具 实现完整的知识库管理

  • add_note -创建新笔记

  • search_notes -按内容、标签或类别搜索
  • get_note -检索完整笔记内容
  • update_note -修改现有注释(替换或追加)
  • list_notes -列出带有可选过滤器的注释
  • delete_note -删除笔记(带备份)
  • list_categories -查看所有类别和计数

  • 智能搜索 具有相关性评分

  • 跨标题、内容、标签和元数据搜索

  • 不区分大小写的匹配
  • 按类别或标签筛选
  • 按相关性对结果进行排名

  • 灵活的组织

  • 默认类别:人员、食谱、会议、程序、任务

  • 可配置的分类系统
  • 基于标签的组织
  • 丰富的元数据支持

  • 数据安全

  • 更新前的自动备份

  • 原子文件写入
  • 人类可读的标记格式
  • 无供应商锁定

  • Web用户界面 (第二阶段)

  • 干净、深色主题的界面

  • 类别导航和搜索
  • 笔记创建和编辑
  • 使用JWT令牌进行身份验证
  • 适用于桌面和移动浏览器

安装

先决条件

  • Python 3.11或更高版本
  • uv 包管理器(推荐)或 pip

使用紫外线进行安装(推荐)```bash

Clone the repository

git clone
cd knowledge-base-mcp

Install dependencies

uv sync

The server is now ready to use


### 使用pip安装```bash
# Clone the repository
git clone
cd knowledge-base-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install in development mode
pip install -e .

运行服务器

该项目提供 双向 运行知识库:

选项1:MCP服务器(用于克劳德桌面/代码)

MCP服务器通过stdio运行,旨在与Claude Desktop或Claude Code一起使用。

启动MCP服务器:```bash

Using uv

uv run knowledge-base-server

Using pip/venv

knowledge-base-server


MCP服务器将:

- 在stdin/stdout上监听MCP协议消息
- 等待来自MCP客户端(如Claude Desktop)的命令
- 不显示web界面或HTTP端点

**注:** MCP服务器通常不是独立运行的。相反,在Claude Desktop中配置它(请参阅下面的配置部分),并让Claude Desktop管理服务器生命周期。

### 选项2:HTTP API服务器(用于Web/API访问)

HTTP API服务器提供web接口和REST API。

**快速入门(无身份验证):**

默认情况下,身份验证为 **残疾的** 便于当地发展。只需运行:```bash
# Using uv
uv run knowledge-base-api

# Using pip/venv
knowledge-base-api

# Or run directly with uvicorn
uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload

API服务器将于启动 http://localhost:8000 与:

  • Web用户界面: http://localhost:8000 (如果存在web文件)
  • API文件: http://localhost:8000/docs (Swagger用户界面)
  • 备选文档: http://localhost:8000/redoc (ReDoc)
  • 健康检查: http://localhost:8000/health

使用API(无授权):```bash

Create a note

curl -X POST http://localhost:8000/notes \
-H "Content-Type: application/json" \
-d '{"title": "My Note", "content": "Hello World", "category": "people", "tags": ["test"]}'

List all notes

curl http://localhost:8000/notes

Search notes

curl "http://localhost:8000/search?q=hello"


**可选:启用身份验证**

要启用身份验证(建议用于生产),请创建 `.env.local` 文件:```bash
# Enable authentication
REQUIRE_AUTH=true

# Required when auth is enabled
JWT_SECRET_KEY=your-secret-key-here-change-this-in-production

# Optional - AI features
ANTHROPIC_API_KEY=sk-ant-xxxxx

# Optional - custom paths
KNOWLEDGE_BASE_PATH=~/knowledge-base
CATEGORIES=people,recipes,meetings,procedures,tasks

# Optional - server settings
API_HOST=0.0.0.0
API_PORT=8000
DEBUG=false

生成安全的JWT密钥:```bash

On Linux/macOS

openssl rand -hex 32

Or use Python

python -c "import secrets; print(secrets.token_hex(32))"


**使用带有身份验证的API:**

当 `REQUIRE_AUTH=true`,您需要进行身份验证:

1. 创建帐户:```bash
curl -X POST http://localhost:8000/auth/signup \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "your-password", "full_name": "Your Name"}'
  1. 登录以获取令牌:```bash
    curl -X POST http://localhost:8000/auth/login \
    -H "Content-Type: application/json" \
    -d '{"email": "user@example.com", "password": "your-password"}'

3. 将令牌用于经过身份验证的请求:```bash
curl http://localhost:8000/notes \
-H "Authorization: Bearer YOUR_TOKEN_HERE"

配置

环境变量

创建一个 .env 项目根目录中的文件(可选):```bash

Knowledge base location (default: ~/knowledge-base)

KNOWLEDGE_BASE_PATH=~/knowledge-base

Categories (comma-separated)

CATEGORIES=people,recipes,meetings,procedures,tasks

Server settings

SERVER_NAME=Knowledge Base
LOG_LEVEL=INFO


### Claude桌面设置

将服务器添加到您的Claude Desktop配置中:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**视窗**: `%APPDATA%\Claude\claude_desktop_config.json`

**Linux**: `~/.config/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"knowledge-base": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/knowledge-base-mcp",
"run",
"knowledge-base-server"
]
}
}
}

替代方案(使用pip/venv):```json
{
"mcpServers": {
"knowledge-base": {
"command": "/absolute/path/to/venv/bin/python",
"args": [
"-m",
"knowledge_base_mcp.server"
],
"env": {
"KNOWLEDGE_BASE_PATH": "/path/to/your/knowledge-base"
}
}
}
}


配置后,重新启动Claude Desktop。

## Web UI访问

知识库包括一个网络界面,用于从任何浏览器浏览和编辑笔记。

### 启动Web服务器```bash
# Make sure you're in the project directory
cd knowledge-base-mcp

# Start the FastAPI server (default port 8000)
uvicorn api.main:app --host 0.0.0.0 --port 8000

# Or use the configuration from .env
python -m api.main

首次设置

  1. 打开浏览器 http://localhost:8000
  2. 点击“创建帐户”注册
  3. 输入您的电子邮件和密码(至少8个字符)
  4. 使用您的凭据登录
  5. 开始创建和组织笔记!

特性

  • 分类导航:按类别浏览带有笔记计数的笔记
  • 全文检索:实时搜索所有笔记和标签
  • 注释编辑器:带有自动保存警告的干净markdown编辑器
  • 创建/编辑/删除:对笔记进行完整的CRUD操作
  • 标签管理:用逗号分隔的标签组织笔记
  • 响应式设计:适用于桌面和移动浏览器

移动接入

要从同一网络上的手机访问:```bash

Start server listening on all interfaces

uvicorn api.main:app --host 0.0.0.0 --port 8000

Then access from phone using your computer's IP

Example: http://192.168.1.100:8000


对于远程访问,可以考虑使用Tailscale或部署到云服务。

## 用法

### MCP工具使用

### 交互示例

#### 添加注释```
You: "I just met Sarah Chen at a conference. She works at Tesla on battery
tech and is interested in our AI product. Tag this as important."

Claude: [Calls add_note tool]
✓ Note 'Sarah Chen' created in people/
File: sarah-chen.md
Tags: conference, tesla, important

搜索```

You: "Who did I meet that works on batteries?"

Claude: [Calls search_notes with query="batteries"]
Found 1 result(s):

[people] Sarah Chen [conference, tesla, batteries, important]
Battery engineer at Tesla. Met at tech conference. Interested in AI...


#### 检索笔记```
You: "Show me my note about Sarah Chen"

Claude: [Calls get_note tool]
# Sarah Chen

**Category:** people
**Tags:** conference, tesla, batteries, important
**Date:** 2025-10-21

---

Battery engineer at Tesla...

更新笔记```

You: "Add to Sarah Chen's note that we scheduled a call for next Tuesday"

Claude: [Calls update_note with append=True]
✓ Note 'Sarah Chen' updated successfully
Category: people
Last updated: 2025-10-22


#### 快速参考```
You: "How long do I cook brussels sprouts in the air fryer?"

Claude: [Calls search_notes with query="brussels sprouts"]
Found 1 result(s):

[recipes] Brussels Sprouts [quick, vegetables, air-fryer]
Cook at 400°F for 15-18 minutes, shake halfway through...

知识库结构

您的知识库以markdown文件的形式存储在一个简单的文件夹结构中:```
~/knowledge-base/
├── people/
│ ├── sarah-chen.md
│ ├── john-doe.md
│ └── ...
├── recipes/
│ ├── brussels-sprouts.md
│ ├── chocolate-cake.md
│ └── ...
├── meetings/
│ └── q4-planning.md
├── procedures/
│ └── onboarding-checklist.md
└── tasks/
└── launch-preparation.md


### Markdown格式

每个注释都是一个带有YAML frontmatter的markdown文件:```markdown
---
tags: [conference, tesla, batteries, important]
date: 2025-10-21
category: people
company: Tesla
role: Battery Engineer
email: sarah.chen@tesla.com
---

# Sarah Chen

**Met:** Tech Conference 2025, Silicon Valley
**Contact:** sarah.chen@tesla.com

## Notes

Interested in our AI product for battery optimization.
Has budget approval for Q1 2026.

## Follow-up

- [ ] Send demo link by end of week
- [ ] Schedule call for next Tuesday

元数据字段

必修的:

  • tags:用于分类的标签列表
  • date:创建日期(YYYY-MM-DD)
  • category:类别文件夹名称

可选(特定类别):

  • 人们: company, role, email, phone
  • 食谱: prep_time, cook_time, servings
  • 会议: attendees, meeting_date, location
  • 任务: priority, due_date, status

您可以根据需要添加任何自定义元数据字段。

发展

运行测试```bash

With uv

uv run pytest

With pip

pytest

Run specific test file

pytest tests/test_storage.py

Run with coverage

pytest --cov=knowledge_base_mcp tests/


### 项目结构```
knowledge-base-mcp/
├── src/
│   └── knowledge_base_mcp/
│       ├── __init__.py
│       ├── server.py       # MCP server and tools
│       ├── storage.py      # File operations
│       ├── search.py       # Search functionality
│       └── models.py       # Data models
├── tests/
│   ├── test_server.py      # Integration tests
│   ├── test_storage.py     # Storage layer tests
│   └── test_search.py      # Search tests
├── examples/
│   └── sample-notes/       # Example notes
├── pyproject.toml          # Project configuration
└── README.md

添加自定义类别

编辑您的 .env 文件或环境配置:```bash
CATEGORIES=people,recipes,meetings,procedures,tasks,books,articles,ideas


服务器将自动为新类别创建文件夹。

## 故障排除

### 常见问题

**服务器未出现在Claude Desktop中:**

- 验证中的路径 `claude_desktop_config.json` 是绝对的
- 检查命令路径是否正确(`uv` 或python路径)
- 完全重新启动克劳德桌面
- 检查Claude Desktop日志是否有错误

**未创建注释:**

- 验证 `KNOWLEDGE_BASE_PATH` 存在并且可写
- 检查文件权限
- 确保类别有效(使用 `list_categories` 工具)

**搜索未找到笔记:**

- 验证笔记是否具有正确的YAML frontmatter
- 检查标签是否格式化为列表
- 尝试使用更简单的查询进行搜索
- 使用 `list_notes` 查看存在哪些注释

**权限错误:**

- 确保知识库目录具有写入权限
- 在macOS上,您可能需要在“系统首选项”中授予Claude Desktop磁盘访问权限

### 查看日志

Claude Desktop日志可以帮助诊断问题:

- **macOS**: `~/Library/Logs/Claude/`
- **视窗**: `%APPDATA%\Claude\logs\`
- **Linux**: `~/.config/Claude/logs/`

## 用例

### 会议CRM

使用联系信息、笔记和后续任务跟踪您在会议上遇到的人。

### 食谱收集

存储带有标签、烹饪时间和关于修改的个人笔记的食谱。

### 会议笔记

按主题组织会议议程、讨论点和行动项目。

### 程序文件

维护重复任务的分步程序和清单。

### 任务管理

跟踪项目、截止日期和任务列表,包括优先级和状态。

## 与其他工具集成

### 黑曜石

markdown格式与黑曜石完全兼容。你可以:

- 打开黑曜石知识库
- 用黑曜石或通过克劳德编辑笔记
- 使用黑曜石手机随时随地访问
- 通过黑曜石同步或iCloud同步

### Git版本控制

考虑将git版本控制添加到您的知识库中:```bash
cd ~/knowledge-base
git init
git add .
git commit -m "Initial knowledge base"

这提供了:

  • 所有更改的版本历史记录
  • 恢复更改的能力
  • 备份到远程存储库
  • 协作能力

文件同步

使用任何文件同步服务:

  • iCloud云端硬盘
  • Dropbox
  • Google 云端硬盘
  • 同步

路线图

第2阶段功能(计划中)

  • 用于web和移动访问的HTTP API
  • 用于浏览和编辑的Web UI
  • 通过webhooks集成AI吊坠
  • 自动总结和见解
  • 日历集成
  • 电子邮件集成

未来的考虑因素

  • 多用户支持
  • 实时协作
  • 使用嵌入进行高级搜索
  • 自动标记建议
  • 钞票类型模板系统

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 添加新功能的测试
  4. 确保所有测试通过
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件

支持

  • 报告问题:[GitHub问题]
  • 文档: MCP文件
  • 社区:[MCP Discord]

致谢

内置:

  • 模型上下文协议
  • MCP Python SDK
  • 格式

用克劳德代码制造

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Knowledge Base MCP 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Knowledge Base MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Knowledge Base MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Knowledge Base MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Knowledge Base MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Knowledge Base MCP 能提供哪些能力?

资料显示能力标签包括 知识管理、笔记系统、Python、Claude、搜索功能。具体工具清单以官方文档为准。

Knowledge Base MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Knowledge Base MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。