MCP Expert Server

MCP Expert Server

Um servidor de Protocolo de Contexto de Modelo (MCP) que fornece geração inteligente de consultas e assistência de documentação usando Claude AI. O servidor analisa sua documentação de API e fornece duas ferramentas principais:

• create-query: Gera consultas com base em solicitações em linguagem natural
• documentation: Fornece informações relevantes da documentação com base em perguntas

Pré-requisitos

• Node.js >= 18
• Uma chave de API da Anthropic para Claude

Instalação

1. Clone o repositório
2. Instale as dependências:

npm install

3. Crie um arquivo .env com sua chave de API da Anthropic:

ANTHROPIC_API_KEY=your_api_key_here

Configuração

Antes de executar o servidor, você precisa:

1. Compilar o projeto e executar o script de configuração:

npm run build
npm run setup

Isso irá:

• Criar os diretórios necessários (docs/ e prompts/)
• Criar arquivos de prompt padrão
• Gerar uma descrição inicial do serviço

2. Adicione seus arquivos de documentação de API ao diretório docs/ (suporta arquivos .txt, .md e .json)

3. Opcionalmente, personalize os prompts no diretório prompts/:

   • system-prompt.txt: Prompt principal do sistema para Claude
   • tool-metadata.txt: Contexto adicional para descrições de ferramentas
   • query-metadata.txt: Contexto adicional para geração de consultas
   • service-description.txt: Descrição do serviço gerada automaticamente

Uso

Servidor Autônomo

Inicie o servidor:

npm start

O servidor expõe duas ferramentas via Protocolo de Contexto de Modelo:

• create-query: Gera uma consulta com base em solicitação em linguagem natural

  {
    "name": "create-query",
    "arguments": {
      "request": "Find all users who signed up in the last week"
    }
  }
  

• documentation: Obtém informações da documentação

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

Integração com Claude Desktop

1. Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

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

2. Substitua /ABSOLUTE/PATH/TO/expert-server pelo caminho absoluto real para a instalação do seu servidor.

3. Reinicie o Claude Desktop.

Estrutura de Diretórios

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

Desenvolvimento

• Compile o projeto:

npm run build

• O servidor usa TypeScript e segue uma arquitetura modular
• Todas as interações com Claude são tratadas pela classe ExpertService
• Logs de depuração são gravados em stderr com o prefixo [DEBUG]

Solução de Problemas

Se você encontrar problemas de conexão:

1. Certifique-se de ter executado o script de configuração:

npm run setup

2. Verifique se todos os arquivos necessários existem no diretório prompts/
3. Verifique se seu ANTHROPIC_API_KEY está configurado corretamente
4. Use caminhos absolutos na configuração do seu Claude Desktop
5. Verifique os logs de depuração (gravados em stderr)

Variáveis de Ambiente

• ANTHROPIC_API_KEY: Sua chave de API da Anthropic (obrigatória)

Licença

MIT