LynxPrompt MCP

Navegue, pesquise e gerencie blueprints de configuração de IA e hierarquias de prompt via LynxPrompt

Documentação

LynxPrompt-MCP

Uma ponte mínima que expõe qualquer instância do LynxPrompt como um servidor MCP, permitindo que LLMs naveguem, pesquisem e gerenciem blueprints de configuração de IA.

O que você obtém

Tipo	Para que serve	MCP URI / ID da ferramenta
Recursos	Navegar por blueprints, hierarquias e informações do usuário somente leitura	`lynxprompt://blueprints` `lynxprompt://blueprint/{id}` `lynxprompt://hierarchies` `lynxprompt://hierarchy/{id}` `lynxprompt://user`
Ferramentas	Criar, atualizar, excluir blueprints e gerenciar hierarquias	`search_blueprints` `create_blueprint` `update_blueprint` `delete_blueprint` `create_hierarchy` `delete_hierarchy`

Tudo é exposto por meio de um único endpoint JSON-RPC (/mcp). LLMs / Agentes podem: initialize -> readResource -> listTools -> callTool ... e assim por diante.

Início rápido (Docker Compose)

services:
  lynxprompt-mcp:
    image: drumsergio/lynxprompt-mcp:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - LYNXPROMPT_URL=https://lynxprompt.com
      - LYNXPROMPT_TOKEN=lp_xxx

Nota de segurança: O transporte HTTP escuta em 127.0.0.1:8080 por padrão. Se você precisar expô-lo em uma rede, coloque-o atrás de um proxy reverso com autenticação.

Instalação via npm (transporte stdio)

npx lynxprompt-mcp

Ou instale globalmente:

npm install -g lynxprompt-mcp
lynxprompt-mcp

Isso baixa o binário Go pré-compilado do GitHub Releases para sua plataforma e o executa com transporte stdio. Requer pelo menos um release publicado.

Compilação local

git clone https://github.com/GeiserX/lynxprompt-mcp
cd lynxprompt-mcp

# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuração

Variável	Padrão	Descrição
`LYNXPROMPT_URL`	`https://lynxprompt.com`	URL da instância LynxPrompt (sem barra final)
`LYNXPROMPT_TOKEN`	(obrigatório)	Token da API no formato `lp_xxx`
`LISTEN_ADDR`	`127.0.0.1:8080`	Endereço de escuta HTTP (o Docker define `127.0.0.1:8080`)
`MCP_AUTH_TOKEN`	(vazio)	Token Bearer para autenticação HTTP (obrigatório se LISTEN_ADDR não for loopback)
`TRANSPORT`	(vazio = HTTP)	Defina como `stdio` para transporte stdio

Coloque-os em um arquivo .env (a partir de .env.example) ou defina-os no ambiente.

Testes

Testado com o Inspector e atualmente está totalmente funcional. Antes de fazer um PR, certifique-se de que este servidor MCP se comporte bem por esse meio.

Exemplo de configuração para LLMs clientes

{
  "schema_version": "v1",
  "name_for_human": "LynxPrompt-MCP",
  "name_for_model": "lynxprompt_mcp",
  "description_for_human": "Browse, search, and manage AI configuration blueprints from LynxPrompt.",
  "description_for_model": "Interact with a LynxPrompt instance that stores AI configuration blueprints. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with lynxprompt://. Use listTools to discover available actions and callTool to execute them.",
  "auth": { "type": "bearer", "token": "your-secret-token" },
  "api": {
    "type": "jsonrpc-mcp",
    "url":  "http://localhost:8080/mcp",
    "init_method": "initialize",
    "session_header": "Mcp-Session-Id"
  },
  "logo_url": "https://lynxprompt.com/logo.png",
  "contact_email": "acsdesk@protonmail.com",
  "legal_info_url": "https://github.com/GeiserX/lynxprompt-mcp/blob/main/LICENSE"
}

Créditos

LynxPrompt — Gerenciamento de blueprints de configuração de IA

MCP-GO — implementação moderna de MCP

GoReleaser — releases multi-arquitetura sem complicações

Mantenedores

@GeiserX.

Contribuindo

Sinta-se à vontade para contribuir! Abra uma issue ou envie PRs.

LynxPrompt-MCP segue o Código de Conduta do Contributor Covenant.

Outros Servidores MCP por GeiserX

cashpilot-mcp — Monitoramento de renda passiva
duplicacy-mcp — Monitoramento da saúde de backups
genieacs-mcp — Gerenciamento de dispositivos TR-069
pumperly-mcp — Preços de combustíveis e carregamento de veículos elétricos
telegram-archive-mcp — Arquivo de mensagens do Telegram

Projetos Relacionados

Projeto	Descrição
LynxPrompt	Plataforma auto-hospedada para Regras e Comandos de IA IDE/Ferramentas via WebUI e CLI
lynxprompt-vscode	Extensão VS Code para gerenciamento de arquivos de configuração de IA do LynxPrompt
lynxprompt-action	GitHub Action para sincronizar e validar arquivos de configuração de IA IDE com LynxPrompt
n8n-nodes-lynxprompt	Nó comunitário do n8n para blueprints de configuração de IA do LynxPrompt
homebrew-lynxprompt	Tap Homebrew para o CLI do LynxPrompt