My Docs MCP Server

🚀 My Document MCP Server

This MCP server indexes the full text of all Markdown (.md) files in the specified directory and provides search and access functions through the MCP protocol.

• Offers full-text search (search_docs) as an MCP tools.
• Provides full-text retrieval of files (read_doc) as an MCP resources.
• Developed using TypeScript.

✨ Features

• Full-text Search: Indexes and searches the full text of Markdown files.
• MCP Protocol Support: Communicates with MCP clients via the MCP protocol.
• Multilingual Support: Enhances Japanese search accuracy with the wakachigaki tokenizer.

📦 Installation

1. Install Dependencies

npm install

2. Create the docs Directory and Place Markdown Files

mkdir docs
# Example: Create a test file
echo "# Test\nThis is a test content." > docs/Test.md

3. Build TypeScript

npm run build

💻 Usage Examples

Starting the Server

Development Mode (Run TypeScript Directly)

npm run dev -- [docs directory path]
# Example: npm run dev -- ./docs

Production Environment (Use the Built Files)

npm start -- [docs directory path]
# Example: npm start -- ./docs

• The docs directory path is optional, and the default is docs/.

Testing in MCP Inspector

Use MCP Inspector to test the server's tools and service resources via the GUI.

npm run inspect -- [docs directory path]
# Example: npm run inspect -- ./docs

Or use the built files:

npx -y @modelcontextprotocol/inspector node build/index.js ./docs

Usage Example in Claude Desktop

1. Open the configuration file of Claude Desktop (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json) and add the following server configuration:

{
  "mcpServers": {
    "Document Search": {
      "command": "node",
      "args": [
        "/path/to/docs-search/build/index.js",
        "/path/to/your-project/docs"
      ]
    }
  }
}

• Set command to node and fill in the path of the built server file and the docs directory path in args.
• It is recommended to use absolute paths.

2. After restarting Claude Desktop, search_docs will be displayed in the MCP tool list.

📚 Documentation

Tools and Resources Provided

Tool: search_docs

• Summary: Searches the full text of Markdown files (supports Japanese search with wakachigaki tokenization).
• Input Parameters: Supports fuzzy search and exact matching.
• Output Format: A JSON array containing search results and highlighted parts.

Resource: read_doc

• Description: Retrieves the file content via the MCP resource URI.
• Supported MIME Types: text/markdown

Logging

The server outputs detailed logs to the standard error output (stderr) during major processing steps.

🔧 Technical Details

Technology Stack and Implementation Technologies

• TypeScript: The implementation language for the server's main body.
• @modelcontextprotocol/sdk: Used for MCP protocol communication and protocol implementation.
• MiniSearch: Creates and searches the full-text index of Markdown files, lightweight and efficient.
• wakachigaki: A Japanese text tokenization library used as the tokenizer for MiniSearch, significantly improving Japanese search accuracy.
• fast-glob: Recursively traverses Markdown files in the docs directory.
• Node.js Standard fs/promises, path Modules: Used for file reading and path operations.
• Stdio Server: Communicates with MCP clients (such as Claude Desktop or Inspector) via standard input and output.

📄 License

MIT