MCP Server for Document Management
A local development server that provides a simple interface for managing and accessing markdown documents using the Model Context Protocol (MCP).
Features
- Serve markdown documents from a local directory
- List available documents
- Read document contents
- Simple and fast local development setup
- Support for both direct MCP and SSE communication
Project Structure
.
├── documents/ # Directory containing markdown files
├── tools/ # Tool definitions
├── resources/ # Resource templates
├── utils/ # Utility functions
└── server.js # Main server file
Setup
- Install dependencies:
npm install
- Create a
documentsdirectory in the project root and add your markdown files:
mkdir documents
- Start the server:
npm start
- In a separate terminal, run the inspector:
npm run inspect
Usage
The server provides the following functionality:
-
List Documents:
- Access available markdown files through the inspector
- Files are listed with their names (without .md extension)
-
Read Documents:
- Click on any document in the inspector to view its contents
- Documents are served with proper markdown formatting
-
File Management:
- Add new markdown files to the
documentsdirectory - Files are automatically detected and made available
- Only
.mdfiles are supported
- Add new markdown files to the
Development
The server uses:
- Express.js for the web server
- Model Context Protocol (MCP) for communication
- SSE (Server-Sent Events) for real-time updates
- Direct MCP communication for simple requests
Error Handling
The server includes:
- Automatic port conflict resolution
- Graceful error handling for file operations
- Connection management for SSE
- Proper cleanup of resources
Notes
- This is a local development server, not intended for production use
- No security measures are implemented as it's meant for local use only
- File operations are optimized for quick access and response
lv.