Focus Docs MCP

Servidor MCP (Model Context Protocol) para consultar a documentação do FocusNFe.

Sobre

Este projeto fornece um servidor MCP que permite consultar facilmente a documentação da API do FocusNFe diretamente através de ferramentas compatíveis com MCP.

Funcionalidades

• Busca na documentação: Busque por tópicos específicos na documentação do FocusNFe
• Conteúdo de páginas: Obtenha o conteúdo completo de páginas específicas da documentação
• Lista de endpoints: Liste os endpoints disponíveis na API
• Exemplos de código: Obtenha exemplos de código e requisições da API

Ferramentas disponíveis

search_focus_docs

Busca na documentação do FocusNFe por tópicos específicos.

Parâmetros:

• query (obrigatório): Termo de busca ou tópico específico
• section (opcional): Seção específica da documentação (nfe, nfse, cte, mdfe, nfce, webhook, api)

get_focus_doc_page

Obtém o conteúdo completo de uma página específica da documentação.

Parâmetros:

• url (obrigatório): URL da página da documentação FocusNFe

list_focus_endpoints

Lista os endpoints disponíveis na API do FocusNFe.

Parâmetros:

• service (opcional): Serviço específico (nfe, nfse, cte, mdfe, nfce)

get_focus_api_examples

Obtém exemplos de código e requisições da API FocusNFe.

Parâmetros:

• endpoint (obrigatório): Endpoint específico para obter exemplos
• language (opcional): Linguagem de programação dos exemplos (curl, php, python, javascript, java, csharp)

Instalação

Instalação Global via NPM

npm install -g focus-docs-mcp

Instalação Local

git clone <repository-url>
cd focus-docs-mcp
npm install
npm run build

Uso

Como um pacote global

Após a instalação global, o servidor pode ser iniciado com:

focus-docs-mcp

Desenvolvimento

Para desenvolvimento local:

npm run dev

Para build do projeto:

npm run build

Configuração no Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "focus-docs": {
      "command": "focus-docs-mcp"
    }
  }
}

Exemplos de uso

Buscar informações sobre NFe

Busque na documentação do FocusNFe sobre "emissão de NFe"

Obter exemplos de código

Obtenha exemplos de código para o endpoint /api/nfe em Python

Listar endpoints de NFSe

Liste os endpoints disponíveis para NFSe

Tecnologias utilizadas

• TypeScript
• Model Context Protocol SDK
• Cheerio (para parsing HTML)
• Node-fetch (para requisições HTTP)

Licença

MIT

Contribuições

Contribuições são bem-vindas! Por favor, abra uma issue ou pull request.

Autor

Cristiano Leite