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,tenant2notes:存储Markdown注释的目录路径(默认:notes),第一个子目录是租户。listen:HTTP服务器侦听地址(默认值:8898)ids:逗号分隔的租户ID列表,用于支持多租户,必须至少提供一个租户
许可证
此项目根据BSD 3条款许可证获得许可-请参阅 许可证 文件以获取详细信息。
贡献
欢迎投稿!请随时提交拉取请求。
