mcp-expert-server v1.0.1

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

From npm

npm install -g mcp-expert-server

From Source

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

Setup

Before running the server, you need to:

1. Build the project and run the setup script:

# If installed from npm:
mcp-expert-server setup

# If installed from source:
npm run build
npm run setup

This will:

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

2. Add your API documentation files to the docs/ directory (supports .txt, .md, and .json files)

3. 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:

# If installed from npm:
mcp-expert-server

# If installed from source:
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

1. Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "expert": {
      "command": "mcp-expert-server",
      "env": {
        "ANTHROPIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Restart Claude Desktop.

Directory Structure

When running the server, it expects the following structure in your current directory:

.
├── 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

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:

1. Ensure you've run the setup script:

mcp-expert-server setup

2. Check that all required files exist in the prompts/ directory
3. Verify your ANTHROPIC_API_KEY is correctly set
4. Check the debug logs (written to stderr)

Environment Variables

• ANTHROPIC_API_KEY: Your Anthropic API key (required)

License

MIT