Token导航 LogoToken导航

MCP Server · 文档知识

Percival Notes MCP

percival.OS的MCP服务器,用于使用Markdown和YAML frontmatter进行协作式笔记管理,具有安全加固和与Nanobot代理深度集成的特点。

stdio官方级别未说明来源级核验工具 12
知识管理Python本地处理隐私保护

快速开始

作者 / 组织
bill-kopp-ai-dev
提供方
bill-kopp-ai-dev
运行时
Python

工具数量

12

来源目录标注

资源数量

0

来源目录标注

提示词数量

0

来源目录标注

GitHub Star

0

仓库热度

收录来源

1 个

MCP World

选型结论

Percival Notes MCP 属于文档知识类 MCP Server,公开资料标注 12 个工具,通过stdio 本地进程接入,客户端适配情况以官方文档为准,有可以直接复制的安装命令;接入前先确认权限范围。

分类

文档知识

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

uv run --directory /path/to/percival-notes-mcp pytest -q

公开命令不是通用的启动方式,拼不出可靠配置示例;请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

  1. 1

    准备运行环境

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

  2. 2

    安装服务

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

  3. 3

    写入客户端配置

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

  4. 4

    验证是否可用

    连接成功后客户端会列出 12 个工具,随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

详细介绍

🤖 珀西瓦尔笔记-珀西瓦尔。操作系统MCP

版本0.0.2

📋 描述

MCP服务器,用于使用Markdown+YAML frontmatter进行协作笔记管理,具有安全强化功能,并与Nanobot代理深度集成。

此服务器是 珀西瓦尔。操作系统 生态系统,一个为自治、安全和绝对隐私而设计的个人代理操作系统。

______________________________________________________________________

🛡️ 珀西瓦尔。操作系统原理

与所有组件一样 percival.OS,此MCP服务器严格遵循我们的核心原则:

  • 隐私第一:所有纸币处理都在本地执行。你的笔记永远不会离开你的基础设施。
  • 数据主权:您可以完全控制笔记的存储位置和访问方式。
  • 强化安全:严格的根遏制(路径遍历阻塞)和不可信的数据包络标记,以降低快速注入风险。
  • 透明度:开源和可审计,以确保对数据的全面治理。

______________________________________________________________________

🚀 功能和工具

这 percival-notes-mcp 提供先进的知识管理功能:

  • notes_read(path):读一个便条。
  • notes_write(path, yaml_frontmatter, markdown_content):创建或更新注释。
  • notes_glob(pattern):列出与模式匹配的文件。
  • notes_mkdir(path):创建一个目录。
  • notes_rm(path):删除文件。
  • notes_rmdir(path):删除目录。
  • notes_search(query, path=".", in_markdown=false):在首页或内容中搜索。
  • notes_list_tags():列出笔记中的所有唯一标签。
  • notes_get_backlinks(path):查找链接到特定注释的注释。
  • notes_read_multiple(paths):在一次通话中阅读多个笔记。
  • notes_get_stats():获取存储库概述(总计、顶部标签等)。
  • notes_get_status():检查服务器运行状态。

______________________________________________________________________

⚙️ percival中的配置。操作系统(纳米机器人)

将以下配置添加到您的 ~/.nanobot/config.json:

{
  "tools": {
    "mcpServers": {
      "percival-notes-mcp": {
        "command": "uv",
        "args": [
          "run",
          "--directory",
          "/path/to/percival-notes-mcp",
          "percival-notes-mcp",
          "/path/to/your-notes"
        ],
        "enabledTools": ["notes_read", "notes_write", "notes_glob", "notes_mkdir", "notes_rm", "notes_rmdir", "notes_search"],
        "toolTimeout": 30
      }
    }
  }
}

______________________________________________________________________

🛠️ 开发与测试

此项目使用 uv 用于依赖性管理。

# Run tests
uv run --directory /path/to/percival-notes-mcp pytest -q

# Run locally
uv run --directory /path/to/percival-notes-mcp percival-notes-mcp /path/to/my-notes

______________________________________________________________________

📚 关于项目

此服务器是 珀西瓦尔。操作系统 项目。它是原始的进化 notes-mcp Edvard Lindelof,针对珀西瓦尔生态系统进行了优化。

  • 主存储库:
  • 许可证:MIT

______________________________________________________________________

*与开发❤️ 由珀西瓦尔。操作系统团队*

工具与能力

工具数量

12

资源数量

0

提示词数量

0

能力标签

笔记管理Python本地部署MarkdownYAML安全加固本地处理隐私保护

数量来自来源目录的标注,具体工具清单以官方文档为准。

典型使用场景

读长文档提问

把 PDF、Markdown 和笔记交给模型,按章节追问细节。

整理知识库

把零散资料归档、打标签,检索时更容易命中。

批量出摘要

提取要点,输出能直接引用的段落。

选择建议

值得选的地方

  • 工具数量 12 个,一次接入能覆盖的操作比单点工具更全。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 公开说明写得比较完整,接入前能看清能力边界。

先想清楚的地方

  • stdio 方式要求本地装好 Python,换机器要重新装一遍。
  • 第三方目录整理,版本更新和行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

5 个同类
MCP Server工具数传输方式安装命令收录来源最后核验
Percival Notes MCP

MCP World · 本页

12stdio有1 个2026-05-17
Cherry Studio

MCP World

0未说明未标注1 个2026-05-17
Pdf Math Translate

MCP World

0stdio有1 个2026-05-17
report generation

MCP World

0stdio有1 个2026-05-17
Anything To Notebooklm

MCP World

0stdio有1 个2026-05-17

按同分类和工具数量挑出最接近的几条,字段以各自详情页为准。

常见问题

5 条

Percival Notes MCP 怎么安装?

公开资料给出的安装命令是 uv run --directory /path/to/percival-notes-mcp pytest -q,运行环境为 Python。装完后按客户端要求写进 MCP 配置,重启客户端生效。

Percival Notes MCP 怎么在 Claude Desktop、Cursor 里配置?

它是stdio 本地进程,客户端配置里要写启动命令和参数,运行环境是 Python;保存后完全退出客户端再打开,配置才会生效。

Percival Notes MCP 收费吗?

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

Percival Notes MCP 需要 API Key 吗?

公开资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Percival Notes MCP 支持哪些客户端?

公开资料没有标注具体客户端;能配置本地 MCP 命令的客户端都能接,配置方式参照官方文档。

来源信息

继续浏览同类 MCP