MCP Expert Server

A Model Context Protocol server that provides intelligent query generation and documentation assistance using Claude AI. The server analyzes your API documentation and provides two main tools:

create-query: Generates queries based on natural language requests
documentation: Provides relevant documentation information based on questions

Prerequisites

Node.js >= 18
An Anthropic API key for Claude

Installation

Clone the repository
Install dependencies:

npm install

Create a .env file with your Anthropic API key:

ANTHROPIC_API_KEY=your_api_key_here

Setup

Before running the server, you need to:

Build the project and run the setup script:

npm run build
npm run setup

This will:

Create the required directories (docs/ and prompts/)
Create default prompt files
Generate an initial service description

Add your API documentation files to the docs/ directory (supports .txt, .md, and .json files)
Optionally customize the prompts in the prompts/ directory:
- system-prompt.txt: Main system prompt for Claude
- tool-metadata.txt: Additional context for tool descriptions
- query-metadata.txt: Additional context for query generation
- service-description.txt: Auto-generated service description

Usage

Standalone Server

Start the server:

npm start

The server exposes two tools via the Model Context Protocol:

create-query: Generate a query based on natural language request
{ "name": "create-query", "arguments": { "request": "Find all users who signed up in the last week" } }
documentation: Get information from the documentation
{ "name": "documentation", "arguments": { "request": "How do I authenticate API requests?" } }

Claude Desktop Integration

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "expert": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace /ABSOLUTE/PATH/TO/expert-server with the actual absolute path to your server installation.
Restart Claude Desktop.

Directory Structure

.
├── docs/                  # Your API documentation files
├── prompts/              # System prompts and metadata
│   ├── system-prompt.txt    # Main system prompt
│   ├── tool-metadata.txt    # Tool description context
│   ├── query-metadata.txt   # Query generation context
│   └── service-description.txt  # Generated service description
├── src/                  # Source code
│   ├── index.ts            # Entry point
│   ├── server.ts           # MCP server implementation
│   └── services/           # Core services
│       └── expertService.ts  # Claude integration
└── package.json

Development

Build the project:

npm run build

The server uses TypeScript and follows a modular architecture
All Claude interactions are handled by the ExpertService class
Debug logs are written to stderr with [DEBUG] prefix

Troubleshooting

If you encounter connection issues:

Ensure you've run the setup script:

npm run setup

Check that all required files exist in the prompts/ directory
Verify your ANTHROPIC_API_KEY is correctly set
Use absolute paths in your Claude Desktop config
Check the debug logs (written to stderr)

Environment Variables

ANTHROPIC_API_KEY: Your Anthropic API key (required)

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MTS MCP Server
CalvinMagezi
-
security
F
license
-
quality
A comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.
Last updated -
5
MCP Outline Server
Vortiago
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
32
MIT License
Scrapeless MCP Server
scrapeless-ai
A
security
A
license
A
quality
A Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.
Last updated -
1
89
41
MIT License
microCMS MCP Server
microcmsio
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with microCMS content management system through six core tools for performing CRUD operations on microCMS list-type APIs.
Last updated -
10
166
12
MIT License

View all related MCP servers

MCP Expert Server