AVR Docs MCP Server with Wiki.JS Integration

This MCP (Model Context Protocol) server provides integration with Wiki.JS for searching and listing pages from your Wiki.JS instance.

Features

• Search Wiki.JS Pages: Search for pages using keywords or topics
• List Wiki.JS Pages: Get a paginated list of all available pages
• Get Specific Page: Retrieve a specific page by its ID
• Connection Testing: Test the connection to your Wiki.JS instance

Setup

Prerequisites

1. A running Wiki.JS instance
2. An API key with appropriate permissions for reading pages

Environment Variables

You can set environment variables in two ways:

Option 1: Using a .env file (Recommended)

1. Copy the example environment file:

cp .env.example .env

2. Edit the .env file with your actual values:

# Wiki.JS Configuration
WIKI_JS_BASE_URL=https://your-wiki-instance.com
WIKI_JS_API_KEY=your-api-key-here
LOG_LEVEL=info

Option 2: Using system environment variables

export WIKI_JS_BASE_URL="https://your-wiki-instance.com"
export WIKI_JS_API_KEY="your-api-key-here"
export LOG_LEVEL="info"

Installation

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Test the connection (optional):

npm test

4. Run the server:

npm start

For development:

npm run dev

Available Tools

1. search_wiki_pages

Search for pages in Wiki.JS using keywords.

Parameters:

• query (required): The search query
• page (optional): Page number for pagination (default: 1)
• limit (optional): Number of results per page (default: 10, max: 50)

2. list_wiki_pages

List all available pages in Wiki.JS.

Parameters:

• page (optional): Page number for pagination (default: 1)
• limit (optional): Number of results per page (default: 20, max: 50)

3. get_wiki_page

Get a specific page by its ID or path.

Parameters:

• pageId (required): The ID (numeric) or path (string) of the page to retrieve. Examples: '3' for ID, 'deepgram' for path

Wiki.JS API Configuration

This MCP server uses Wiki.JS GraphQL API (/graphql endpoint). Make sure your Wiki.JS instance has API access enabled and that your API key has the following permissions:

• page:read - To read page content
• page:list - To list pages
• search:read - To search pages

The server automatically handles GraphQL queries and responses for all operations. Note that Wiki.JS GraphQL API has some limitations:

• Search and list operations don't support native pagination, so pagination is simulated client-side
• Search results don't include full page content
• List results don't include full page content (use get_wiki_page for full content)
• Tags are returned as arrays of strings, not comma-separated strings

Logging

The server includes comprehensive logging with configurable log levels:

• debug - Detailed debug information
• info - General information (default)
• warn - Warning messages only
• error - Error messages only

Set the LOG_LEVEL environment variable to control logging verbosity.

Error Handling

The server includes comprehensive error handling for:

• Missing environment variables
• Network connectivity issues
• API authentication failures
• Invalid page IDs
• Rate limiting

Development

To run in development mode with hot reloading:

npm run watch

Building

To build for production:

npm run build

The compiled JavaScript will be in the dist/ directory.

Support & Community

• GitHub: https://github.com/agentvoiceresponse - Report issues, contribute code.
• Discord: https://discord.gg/DFTU69Hg74 - Join the community discussion.
• Docker Hub: https://hub.docker.com/u/agentvoiceresponse - Find Docker images.
• Wiki: https://wiki.agentvoiceresponse.com/en/home - Project documentation and guides.

Support AVR

AVR is free and open-source. If you find it valuable, consider supporting its development:

License

MIT License - see the LICENSE file for details.