Glama
Sign In

MCP Expert Server

by crazyrabbitLTC
npmGitHub
TypeScript
3
1
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Utilizes environment variables for configuration, particularly for storing the Anthropic API key

  • Uses Node.js as the runtime environment for the MCP server, requiring version 18 or higher

  • Implements the server using TypeScript for type safety and modularity in the codebase

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

  1. Clone the repository
  2. Install dependencies:
npm install
  1. 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:
npm run build npm run setup

This will:

  • Create the required directories (docs/ and prompts/)
  • Create default prompt files
  • Generate an initial service description
  1. Add your API documentation files to the docs/ directory (supports .txt, .md, and .json files)
  2. 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

  1. 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" } } } }
  1. Replace /ABSOLUTE/PATH/TO/expert-server with the actual absolute path to your server installation.
  2. 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:

  1. Ensure you've run the setup script:
npm run setup
  1. Check that all required files exist in the prompts/ directory
  2. Verify your ANTHROPIC_API_KEY is correctly set
  3. Use absolute paths in your Claude Desktop config
  4. 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
F
license - not found
-
quality - not tested

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

  1. Prerequisites
    1. Installation
      1. Setup
        1. Usage
          1. Standalone Server
          2. Claude Desktop Integration
        2. Directory Structure
          1. Development
            1. Troubleshooting
              1. Environment Variables
                1. License

                  Related Resources