MCP Plugable Document Server

🚀 MCP Document Server

A simple document search and retrieval server implementing the Model Context Protocol (MCP).

✨ Features

• Store and retrieve documents using MCP.
• Semantic search functionality.
• Compatible with Cursor and other MCP clients.
• Plug - and - play document service architecture:
  • Local JSON document storage.
  • Confluence integration for searching workspace documents.
• Support for HTML.

📦 Installation

1. Install dependencies:

npm install

2. Build the TypeScript code:

npm run build

3. Start the server:

npm run stdio

💻 Usage Examples

Using with Cursor

This server is designed to work with Cursor. You can search for documents using the search tool with keyword parameters.

Example:

search({
  keyword: "data"
})

Creating Documents

You can create new documents directly from Cursor:

create_document({
  title: "New Confluence Page",
  content: "This is a page created in Confluence",
  serviceId: "confluence"
})

📚 Documentation

Document Services

The architecture is based on plug - and - play document services. Each service implements a common interface for searching and retrieving documents.

Local Storage Service

The local storage service saves documents to the local file system:

• Documents are stored in the data/documents/ directory (automatically created on demand).
• Metadata is stored in data/documents.json (automatically created on demand).
• Supports document content in Markdown and HTML formats.

Confluence Service

The Confluence service uses the Confluence REST API and CQL (Confluence Query Language) to search workspace documents. To enable this feature, set the following environment variables:

# Confluence configuration
export CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki"
export CONFLUENCE_USERNAME="your-email@example.com"
export CONFLUENCE_API_TOKEN="your-api-token"
export CONFLUENCE_SPACE="your-space-key"

You can set these variables before starting the server:

CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki" \
CONFLUENCE_USERNAME="your-email@example.com" \
CONFLUENCE_API_TOKEN="your-api-token" \
CONFLUENCE_SPACE="your-space-key" \
npm run stdio

Authentication Details

The service uses basic authentication with your email and API token. The credentials are sent as a Base64 - encoded string in the authorization header:

Authorization: Basic <base64-encoded-email:token>

Managing Documents

The local storage service automatically creates the data/documents directory and the data/documents.json file (generated on demand). These files are not in the repository and are automatically generated as needed.

Extending the Server

Adding New Document Services

The MCP server is designed to be extensible. You can easily add new document services by implementing the DocumentService interface:

interface DocumentService {
  id: string;
  getByKeywords: (keywords: string[]) => Promise<Document[]>;
  createDocument?: (title: string, content: string) => Promise<Document>;
}

To add a new service:

1. Create a new directory for your service under the src/services/ directory.
2. Implement the DocumentService interface.
3. Register your service in src/services/index.ts.

Some possible directions for document service implementation:

• Google Drive: Connect to the Google Drive API for document storage and retrieval.
• OneDrive/SharePoint: Integrate Microsoft's document services.
• Notion: Add support for Notion workspaces.
• GitHub Wiki: Connect to the GitHub Wiki for document management.
• Custom Database: Store documents in a SQL or NoSQL database.