MCP cover image
See in Github
2025-01-07

Un servidor MCP que puede crear consultas y obtener información de la documentación de la API.

1

Github Watches

3

Github Forks

3

Github Stars

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

相关推荐

  • NiKole Maxwell
  • I craft unique cereal names, stories, and ridiculously cute Cereal Baby images.

  • https://jgadvisorycpa.com
  • This GPT assists in finding a top-rated business CPA - local or virtual. We account for their qualifications, experience, testimonials and reviews. Business operators provide a short description of your business, services wanted, and city or state.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • apappascs
  • Descubra la colección más completa y actualizada de servidores MCP en el mercado. Este repositorio sirve como un centro centralizado, que ofrece un extenso catálogo de servidores MCP de código abierto y propietarios, completos con características, enlaces de documentación y colaboradores.

  • ShrimpingIt
  • Manipulación basada en Micrypthon I2C del expansor GPIO de la serie MCP, derivada de AdaFruit_MCP230xx

  • OffchainLabs
  • Implementación de la prueba de estaca Ethereum

  • modelcontextprotocol
  • Servidores de protocolo de contexto modelo

  • huahuayu
  • Una puerta de enlace de API unificada para integrar múltiples API de explorador de blockchain similar a Esterscan con soporte de protocolo de contexto modelo (MCP) para asistentes de IA.

  • Mintplex-Labs
  • La aplicación AI de escritorio todo en uno y Docker con trapo incorporado, agentes de IA, creador de agentes sin código, compatibilidad de MCP y más.

    Reviews

    3 (1)
    Avatar
    user_Hcp2yQFs
    2025-04-16

    The "Kokoro MCP Server Development Environment Setup Guide" by NewAITees is an essential resource for anyone serious about MCP applications. The guide is incredibly detailed, making the setup process straightforward even for those new to the field. The clear instructions and comprehensive coverage ensure that you won't miss a step. Highly recommended for all MCP enthusiasts!