文档服务器工具

MCP开发助手

专为开发人员设计的超高速、低资源本地文档服务器。通过单个端点从多个项目提供Markdown文档，可以直接从IDE或通过Cursor中的MCP（模型上下文协议）访问。

特性

• 🚀 快速HTTP服务器 -具有web UI的本地Fastify服务器
• 🤖 MCP集成 -通过Cursor的AI直接访问文档
• 📝 VS代码扩展 -查看文档 Alt+D 键盘快捷键
• 🔄 热重新加载 -文档更改时自动重新加载
• ⚡ 内存缓存 -低于50毫秒的响应时间
• 📚 多项目 -在一个地方管理多个项目的文档

项目结构

这是一个包含以下内容的monorepo：

• packages/core -HTTP服务器和CLI(自述文件)
• packages/mcp-server -用于Cursor AI集成的MCP服务器(自述文件)
• packages/vscode-plugin -VS代码扩展(自述文件)

快速开始

1.安装依赖项

npm install
npm run build

2.配置项目

创建 ~/.mcp-dev-helper/config.yml:

projects:
  - id: 'react-native'
    path: '/absolute/path/to/docs/react-native'
  - id: 'api'
    path: '/absolute/path/to/docs/api'
  - id: 'full-app'
    path: '/absolute/path/to/docs/full-app'

3.运行服务器

从项目根：

npm start

服务器将于启动 http://localhost:7777。在浏览器中打开它以查看您的文档！

要停止服务器，请执行以下操作：

npm run stop

4.选择您的集成

• HTTP服务器和CLI -请参阅 packages/core/README.md
• MCP服务器（游标AI） -请参阅 软件包/mcp服务器/README.md
• VS代码扩展 -请参阅 软件包/vcode-plugin/README.md

配置

配置文件位置

~/.mcp-dev-helper/config.yml

配置格式

projects:
  - id: 'project-id'        # Unique identifier
    path: '/absolute/path'   # Absolute path to docs folder

需求

• 每个项目都必须有一个唯一的 id
• 路径必须是绝对的
• 服务器监视所有 .md 递归文件
• 配置更改会自动重新加载

发展

构建所有包

npm run build

观看模式

# Core server (from project root)
npm run dev

# VS Code extension
cd packages/vscode-plugin && npm run watch

# MCP server
cd packages/mcp-server && npm run dev

装订和格式化

npm run lint
npm run lint:fix
npm run format

文档

• HTTP服务器和CLI指南 -HTTP服务器和CLI命令的完整指南
• MCP服务器指南 -Cursor AI集成的设置和使用
• VS代码扩展指南 -VS Code中的安装和使用

许可证

麻省理工学院