Crazyrabbitltc MCP Expert Server

🚀 MCP Expert Server

An MCP (Model Context Protocol) server leveraging Claude AI to provide intelligent query generation and documentation assistance. It analyzes your API documentation and offers two main tools:

• create-query: Generate queries based on natural language requests.
• documentation: Provide relevant documentation information based on questions.

🚀 Quick Start

✨ Features

• Generate queries according to natural language requests.
• Provide relevant documentation information based on questions.

📦 Installation

Prerequisites

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

Steps

1. Clone the repository.
2. Install dependencies:

npm install

3. Create a .env file containing your Anthropic API key:

ANTHROPIC_API_KEY=your_api_key_here

🔧 Setup

Before running the server, please do the following:

1. 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.

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

💻 Usage Examples

Standalone Server

Start the server:

npm start

The server provides two tools through the Model Context Protocol (MCP):

Basic Usage

• create-query: Generate queries based on natural language requests.

{
    "name": "create-query",
    "arguments": {
        "request": "Find all users registered in the past week."
    }
}

• documentation: Retrieve information from the documentation.

{
    "name": "documentation",
    "arguments": {
        "request": "How to authenticate API requests?"
    }
}

Claude Desktop Integration

1. Add the following configuration to your Claude desktop configuration file:

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

2. Replace /ABSOLUTE/PATH/TO/expert-server with the actual absolute path of the server installation.
3. Restart Claude Desktop.

🔧 Technical Details

• The server is developed using TypeScript and follows a modular architecture.
• All Claude interactions are handled by the ExpertService class.
• Debug logs are recorded to stderr with a [DEBUG] prefix.

📚 Troubleshooting

If you encounter connection issues:

1. Ensure that the setup script has been run:

npm run setup

2. Check if all required files exist in the prompts/ directory.
3. Verify that your ANTHROPIC_API_KEY is correctly set.
4. Use the absolute path in the Claude desktop configuration.
5. Check the debug logs for more information.

📄 Environment Variables

📄 License

This project is licensed under the MIT License.