Mvp MCP Server_MD Notes

最小化 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 主机          | ----> | MCP 服务器        | ----> | 文件系统         |
| (Claude/其他 LLM)|       | (Express 服务器)  |       | (笔记存储)       |
|                   | <---- |                   | <---- |                 |
+-------------------+       +-------------------+       +-----------------+

目录结构

mcp-notes-server/
├── package.json
├── server.js              # 主入口点
├── routes/
│   └── mcp-router.js      # MCP 协议路由器
├── tools/
│   └── notes-tool.js      # 笔记检索实现
└── notes/                 # 包含 Markdown 笔记的目录
    └── ... (你的 .md 文件)

组件

1. MCP 路由器

处理 MCP 协议请求：

• 发现端点 (/discover): 返回可用的工具和函数
• 调用端点 (/invoke): 处理工具函数调用

2. 笔记工具

实现笔记检索功能：

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

实现计划

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