mcpField
M
Mvp MCP Server_MD Notes

Mvp MCP Server_MD Notes

本地服务
github.com/AlekOmOm记忆与知识082 周前更新
代码仓库

关于 Mvp MCP Server_MD Notes

Mvp MCP Server_MD Notes 是一个用于读取和检索 Markdown 笔记的精简 JavaScript MCP 服务，供需要访问笔记目录的 LLM 主机使用。它支持列出、搜索和读取笔记文件。

主要功能

  1. 01列出可用笔记
  2. 02读取指定笔记
  3. 03搜索笔记
  4. 04从磁盘读取 Markdown 文件

适用场景

  1. 01通过简单搜索查找笔记
  2. 02为 LLM 主机检索笔记内容

MCP 相关

它通过发现和调用端点向 MCP 客户端提供笔记列表、读取和搜索功能。

#mcp-server#notes-retrieval#minimal-design

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

最小化的 MCP 服务设计

  • 检索和阅读笔记。

要求

  1. 创建一个实现 Model-Context-Protocol 的最小化 MCP 服务
  2. 提供检索和阅读 Markdown 笔记的功能
  3. 使用提供的 notes_MCP 作为知识来源
  4. 保持实现精简（MVP）
  5. 使用纯 JavaScript（不使用 TypeScript）

技术栈

  • 运行时：Node.js
  • 框架：Express.js（轻量级 Web 框架）
  • 依赖项：
    • express（HTTP 服务）
    • cors（跨域资源共享）
    • fs（Node.js 文件系统，用于读取笔记）
    • path（路径操作工具）

架构

简单的客户端-服务端架构：

+-------------------+       +-------------------+       +-----------------+
| LLM Host          | ----> | MCP Server        | ----> | File System     |
| (Claude/other LLM)|       | (Express Server)  |       | (Notes Storage) |
|                   | <---- |                   | <---- |                 |
+-------------------+       +-------------------+       +-----------------+

目录结构

mcp-notes-server/
├── package.json
├── server.js              # Main entry point
├── routes/
│   └── mcp-router.js      # MCP protocol router
├── tools/
│   └── notes-tool.js      # Notes retrieval implementation
└── notes/                 # Directory containing your markdown notes
    └── ... (your .md files)

组件

1. MCP 路由器

处理 MCP 协议请求：

  • 发现端点（/discover）：返回可用工具和函数
  • 调用端点（/invoke）：处理工具函数调用
2. 笔记工具

实现笔记检索功能：

  • list_notes：列出可用笔记
  • read_note：检索特定笔记的内容
  • search_notes：简单的笔记搜索功能

实施计划

  1. 设置支持 CORS 的基本 Express 服务
  2. 使用发现和调用端点实现 MCP 路由器
  3. 使用基本文件操作创建笔记工具
  4. 连接组件，并使用 LLM 主机进行测试

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。