mcp-expert

MCP Expert Server provides two built-in tools that leverage Claude AI to assist with API documentation and query generation. The create-query tool builds structured queries from natural language requests, which you can pass to an API or service that consumes MCP-formatted tool invocations. The documentation tool retrieves and surfaces relevant information from your added documentation files, helping you answer questions about authentication, usage, or endpoints described in your docs. You interact with these tools by issuing MCP tool calls via JSON, for example by specifying the tool name and the arguments you want to pass. The server is designed to be run locally or integrated into a client (such as Claude Desktop) that can route queries to the expert service using the provided configuration.

Prerequisites

• Node.js >= 18
• npm (comes with Node.js)
• An Anthropic API key for Claude

Installation steps

1. Clone the repository
2. Install dependencies

npm install

3. Create a .env file with your Anthropic API key

ANTHROPIC_API_KEY=your_api_key_here

4. Build and set up the project

npm run build
npm run setup

This setup creates the docs/ and prompts/ directories, adds default prompts, and generates an initial service description. If you plan to run via Claude Desktop, ensure the absolute path to the built entry point is correctly specified in the client config (see Claude Desktop integration in the README).

Tips and notes:

• Ensure ANTHROPIC_API_KEY is set in your environment or in the integration config (as shown for Claude Desktop).
• After building, the server entry point is typically at build/index.js; use an absolute path when configuring external clients.
• The server logs debug information to stderr with a [DEBUG] prefix; use this to troubleshoot initialization issues.
• Add your API documentation files to docs/ (supported: .txt, .md, .json) and customize prompts in prompts/ if needed.
• If you upgrade dependencies, re-run npm install and npm run build to reflect changes.