文档管理服务器

一个本地开发服务器,提供简单界面用于通过模型上下文协议(MCP)管理和访问Markdown文档。

  • by motiondesignlv
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 motiondesignlv/mcp_server

使用说明

MCP文档管理服务器

一个本地开发服务器,它提供了一个简单的界面,用于使用模型上下文协议(MCP)管理和访问markdown文档。

特性

  • 从本地目录提供markdown文档
  • 列出可用文件
  • 读取文档内容
  • 简单快速的本地开发设置
  • 支持MCP和SSE直接通信

项目结构

.
├── documents/         # Directory containing markdown files
├── tools/             # Tool definitions
├── resources/         # Resource templates
├── utils/             # Utility functions
└── server.js          # Main server file

设置

  1. 安装依赖项:
npm install
  1. 创建一个 documents 在项目根目录中添加您的markdown文件:
mkdir documents
  1. 启动服务器:
npm start
  1. 在单独的终端中,运行检查器:
npm run inspect

用法

服务器提供以下功能:

  1. 列出文件:

    • 通过检查器访问可用的markdown文件
    • 文件按其名称列出(不带.md扩展名)
  2. 阅读文件:

    • 点击检查器中的任何文档以查看其内容
    • 文件以适当的标记格式提供
  3. 文件管理:

    • 将新的markdown文件添加到 documents 目录
    • 自动检测文件并使其可用
    • 仅 .md 支持文件

发展

服务器使用:

  • 用于web服务器的Express.js
  • 用于通信的模型上下文协议(MCP)
  • SSE(服务器发送事件)用于实时更新
  • 针对简单请求的直接MCP通信

错误处理

服务器包括:

  • 自动解决端口冲突
  • 文件操作的优雅错误处理
  • SSE的连接管理
  • 适当清理资源

备注

  • 这是一个本地开发服务器,不用于生产用途
  • 没有实施任何安全措施,因为它仅供本地使用
  • 文件操作经过优化,可快速访问和响应

lv。