MCP Expert Server
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:
Copy
- Create a
.env
file with your Anthropic API key:
Copy
Setup
Before running the server, you need to:
- Build the project and run the setup script:
Copy
This will:
- Create the required directories (
docs/
andprompts/
) - 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 Claudetool-metadata.txt
: Additional context for tool descriptionsquery-metadata.txt
: Additional context for query generationservice-description.txt
: Auto-generated service description
Usage
Standalone Server
Start the server:
Copy
The server exposes two tools via the Model Context Protocol:
- create-query: Generate a query based on natural language requestCopy
- documentation: Get information from the documentationCopy
Claude Desktop Integration
- Add this configuration to your Claude Desktop config file:
Copy
- Replace
/ABSOLUTE/PATH/TO/expert-server
with the actual absolute path to your server installation. - Restart Claude Desktop.
Directory Structure
Copy
Development
- Build the project:
Copy
- 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:
Copy
- 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
A Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.