MCP Expert Server

What is MCP Expert Server?

MCP Expert Server is a Model Context Protocol (MCP) server that generates queries and provides documentation assistance by analyzing API documentation through Claude AI. It is intended for developers who want to integrate natural-language-driven query generation and retrieval-augmented documentation lookup into MCP-compatible applications such as Claude Desktop.

How to use MCP Expert Server?

Install Node.js 18 or later, clone the repository, run npm install, create a .env file with ANTHROPIC_API_KEY, then execute npm run build && npm run setup. Place documentation files (.txt, .md, .json) in the docs/ directory and optionally customize prompts in the prompts/ directory. Start the server with npm start; it exposes two tools: create-query (generate a query from a natural language request) and documentation (retrieve documentation based on a question). For Claude Desktop integration, add an mcpServers entry to the Claude Desktop configuration file with the absolute path to the built server and the API key.

Key features of MCP Expert Server

• Two tools: create-query and documentation
• Supports .txt, .md, and .json documentation files
• Customizable prompts stored in the prompts/ directory
• TypeScript-based, modular architecture with an ExpertService class
• Debug logs written to stderr with [DEBUG] prefix
• Integrates natively with Claude Desktop via MCP configuration

Use cases of MCP Expert Server

• Generate database or API queries from plain English requests
• Ask questions about your API documentation and get relevant answers
• Embed intelligent assistant capabilities into MCP-enabled IDEs or tools
• Automate documentation lookups as part of a larger AI reasoning pipeline

FAQ from MCP Expert Server

What are the prerequisites for running MCP Expert Server?

Node.js version 18 or higher and an Anthropic API key for Claude are required.

How do I install and set up MCP Expert Server?

Clone the repository, install dependencies with npm install, create a .env file with your ANTHROPIC_API_KEY, then run npm run build and npm run setup to create the required directories and default prompt files.

How do I integrate MCP Expert Server with Claude Desktop?

Add an mcpServers entry to the Claude Desktop configuration file with "command": "node", "args": ["/absolute/path/to/expert-server/build/index.js"], and the ANTHROPIC_API_KEY environment variable. Use absolute paths and restart Claude Desktop.

What file formats are supported for documentation files?

MCP Expert Server supports .txt, .md, and .json files placed in the docs/ directory.

How can I troubleshoot connection issues?

Ensure you have run the setup script, all required prompt files exist, the ANTHROPIC_API_KEY is correctly set, absolute paths are used in the Claude Desktop config, and check the debug logs printed to stderr.