Token导航 LogoToken导航

MCP Server · AI代理

Markdown Notes MCP

一个基于Model Context Protocol的MCP服务器,为AI助手提供创建、读取、更新、删除和组织Markdown笔记的功能,支持多租户和图像上传。

stdio官方级别未说明来源级核验工具 0
多租户Python知识管理Docker

快速开始

作者 / 组织
ateska
提供方
ateska
运行时
Docker

工具数量

0

来源目录标注

资源数量

0

来源目录标注

提示词数量

0

来源目录标注

GitHub Star

1

仓库热度

收录来源

1 个

MCP World

选型结论

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

分类

AI代理

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

docker run -it -v$(pwd)/etc:/conf:ro -p 8898:8898 --rm markdown-notes-mcp

客户端配置示例

{
  "mcpServers": {
    "markdown-notes-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-it",
        "-v$(pwd)/etc:/conf:ro",
        "-p",
        "8898:8898",
        "--rm",
        "markdown-notes-mcp"
      ]
    }
  }
}

按公开安装命令拼出来的示例,字段名和参数以仓库 README 为准;带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

  1. 1

    准备运行环境

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

  2. 2

    安装服务

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

  3. 3

    写入客户端配置

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

  4. 4

    验证是否可用

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

接入前确认

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

详细介绍

markdown注意到mcp

MCP服务器,使AI助手能够通过模型上下文协议管理Markdown笔记。 建立在 ASAB 具有多租户支持和图像上传功能的框架。 这个项目也是一个如何使用ASAB框架和Python编写MCP服务器的演示。

概述

markdown-notes-mcp 是一个 主控程序 (模型上下文协议)服务器实现,为AI助手提供创建、阅读、更新、删除和组织Markdown笔记的工具。 该服务器公开了一个标准化的MCP接口,允许AI应用程序与本地或远程的Markdown笔记存储库进行交互。 此MCP服务器提供 _可流式HTTP传输_,它不提供 _标准运输_ (然而)。

最酷的部分是,你可以连接更多的LLM,在Markdown笔记上协同工作;一个是作者,另一个是对手。

模型上下文协议(MCP)是用于将AI应用程序连接到外部数据源和工具的标准化协议。此实现利用了ASAB的微服务框架(aiohttp 内部),提供统一的配置、日志记录、指标和HTTP服务器功能。

特性

  • 完整的CRUD操作:创建、阅读、更新和删除Markdown注释
  • 目录支持:在嵌套目录结构中组织笔记
  • 图片上传:WIP上传和管理图像(JPG、PNG、GIF)以及笔记
  • 多租户支持:每个租户的独立纸币存储
  • 资源模板:通过URI模板访问笔记(note://{path} 和 img://{path})
  • MCP协议合规性:完全支持MCP协议规范
  • 基于ASAB构建:支持async/await的生产就绪微服务框架
  • 安全:路径规范化可防止目录遍历攻击

快速开始

安装到Docker中

git clone 
docker build -t markdown-notes-mcp .

运行服务器

docker run -it -v$(pwd)/etc:/conf:ro -p 8898:8898 --rm markdown-notes-mcp

配置

创建配置文件(例如。, etc/markdown-notes-mcp.conf):

[general]
notes = notes

[web]
listen = 8898

[tenants]
ids = tenant1,tenant2
  • notes:存储Markdown注释的目录路径(默认: notes),第一个子目录是租户。
  • listen:HTTP服务器侦听地址(默认值: 8898)
  • ids:逗号分隔的租户ID列表,用于支持多租户,必须至少提供一个租户

许可证

此项目根据BSD 3条款许可证获得许可-请参阅 许可证 文件以获取详细信息。

贡献

欢迎投稿!请随时提交拉取请求。

参考文献

工具与能力

工具数量

0

资源数量

0

提示词数量

0

能力标签

Markdown管理Python本地部署AI助手多租户笔记管理MCP协议

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

典型使用场景

多步任务编排

把拆解、检索、执行串成一条链,模型按步骤调用工具。

长期上下文

把会话、笔记和知识放到外部存储,换个会话还能接着做。

接自有流程

把内部系统和模型连起来,让助手调用已有的工作流。

选择建议

值得选的地方

  • 只提供 0 个工具,职责集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 公开说明写得比较完整,接入前能看清能力边界。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

MCP World · 本页

0stdio有1 个2026-05-17
Everything Claude Code

MCP World

0stdio有1 个2026-05-17
Filesystem 560c4363

MCP World

13未说明未标注2 个2026-05-17
Time 7365cb6d

MCP.so

2SSE有2 个2026-05-17
Server Everything (everything)

MCP World

11stdio有1 个2026-05-17

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

常见问题

5 条

Markdown Notes MCP 怎么安装?

公开资料给出的安装命令是 docker run -it -v$(pwd)/etc:/conf:ro -p 8898:8898 --rm markdown-notes-mcp,运行环境为 Docker。装完后按客户端要求写进 MCP 配置,重启客户端生效。

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

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

Markdown Notes MCP 收费吗?

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

Markdown Notes MCP 需要 API Key 吗?

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

Markdown Notes MCP 支持哪些客户端?

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

来源信息

继续浏览同类 MCP