Document Archive MCP Server

An implementation of the MCP server based on Node.js and TypeScript, providing document management, context retrieval, and question - answering functions, and supporting multiple transmission methods and configuration options.

Artificial intelligence chatbots Knowledge management and memory #Document Retrieval #Question - Answering System #Context Protocol #AI Service .TypeScript

rating : 2 points

downloads : 15

update time : 2025-04-28

What is the MCP Server?

The MCP server is an implementation of an open protocol that allows applications to provide context information to large language models (LLMs) through a standardized method. This enables AI applications to seamlessly access various data sources and tools.

How to Use the MCP Server?

The MCP server can be run in two ways: stdio (for integrating MCP clients) and SSE (for web infrastructure). Users can easily start the server and configure its functions according to their needs.

Applicable Scenarios

The MCP server is suitable for application scenarios that require providing document retrieval, context management, and question - answering functions for large language models, such as knowledge management systems and intelligent customer service systems.

Main Features

Cross - Document Search ToolSupports retrieving documents related to user queries.

Document ManagementProvides functions for managing document lists and metadata resources.

Document Question - Answering TemplateSupports extracting relevant information from documents based on user questions.

Supports stdio and SSE TransmissionsIs compatible with standard input/output and Server - Sent Events (SSE) transmission methods.

Comprehensive Logging SystemRecords detailed log information for easy debugging and monitoring.

Environment Variable ConfigurationAllows flexible configuration through environment variables.

Readiness ManagementEnsures that all services are initialized before accepting requests.

Graceful ShutdownHandles cleanup work when the server terminates.

Advantages and Limitations

Advantages

Supports multiple transmission methods to meet the needs of different application scenarios.

Provides a powerful logging system for developers to debug easily.

Is easy to expand and maintain, with good flexibility.

Has a standardized interface design for easy integration with other systems.

Limitations

Requires a certain technical background for configuration and operation.

Has certain requirements for hardware performance, especially for large - scale data processing.

Some advanced functions may require additional paid plugins.

How to Use

Install Dependencies

First, ensure that Node.js 22+ and npm are installed, then run the following command to install project dependencies: ```bash npm install ```

Build the Project

Build the project to generate optimized code: ```bash npm run build ```

Start the Server

Use the following command to start the server (default is stdio mode): ```bash npm start ```

Switch to SSE Mode

If you need to use SSE mode, you can add the `--transport=sse` parameter: ```bash npm start -- --transport=sse ```

Usage Examples

Case 1: Cross - Document SearchUsers can quickly find documents related to their questions through the MCP server.

Case 2: Document Question - AnsweringUsers can ask specific questions about a particular document to the server.

Frequently Asked Questions

How to Change the Server's Default Port?

What Transmission Methods Does the MCP Server Support?

How to View Server Logs?

Does the MCP Server Support Multiple Languages?

Related Resources

Official Documentation

The official GitHub repository of the MCP server.

API Documentation

Detailed API interface descriptions.

Tutorial Video

A video tutorial for quickly getting started with the MCP server.

🚀 MCP Server

An implementation of the Model Context Protocol (MCP) server using Node.js and TypeScript.

🚀 Quick Start

Dependencies

Node.js 22+ and npm

Installation

Clone the repository.
Install dependencies:

npm install

Build the project:

npm run build

Running the Server

Using stdio (for integration with MCP clients)

npm start

Using SSE (for web use)

npm start -- --transport=sse

The server will run on the default port 3000. You can change this value by setting the PORT environment variable or using the port parameter:

npm start -- --transport=sse --port=8080

Or:

PORT=8080 npm start -- --transport=sse

✨ Features

This server implementation provides:

Cross-document search tools for retrieving relevant information.
Document management, including document lists and metadata resources.
Document Q&A prompt templates for answering questions about documents.
Support for stdio and SSE transmission methods.
A comprehensive logging system.
Environment variable configuration.
Path management to ensure all services accept requests after initialization.
Graceful shutdown handling for server termination.

📚 Documentation

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes the way applications provide context to large language models (LLMs). It enables seamless communication between AI applications and various data sources and tools.

🔧 Technical Details

System Architecture

💻 Usage Examples

Development

To run the server in development mode with automatic reloading:

npm run dev

For SSE transmission in development mode:

npm run dev -- --transport=sse

📄 License

MIT

📄 API Documentation

Tools

getDocumentsMetadata: Retrieve metadata for available documents.
- Parameters:
  - query (string): The user's original query or question.
checkQueryRelevance: Evaluate relevant documents and return instructions for intent analysis.
- Parameters:
  - query (string): The user's original query or question.
  - files (Array): A list of file paths associated with the query.
getDocumentMetadata: Retrieve metadata for a specific document based on the file path.
- Parameters:
  - file (string): The file path.