WikiJS

Servidor MCP WikiJS

Um servidor Model Context Protocol (MCP) que fornece integração com WikiJS, permitindo que assistentes de IA pesquisem e recuperem conteúdo da sua base de conhecimento WikiJS.

Visão Geral

Este servidor MCP permite que assistentes de IA interajam com instâncias WikiJS fornecendo ferramentas para:

• Pesquisar páginas por string de consulta
• Recuperar páginas por ID
• Recuperar páginas por caminho e localidade
• Obter todas as páginas do wiki

Configuração para Cursor

Stdio

{
  "mcpServers": {
    "wikijs-mcp": {
      "command": "npx",
        "args": [
            "wikijs-mcp"
        ],
        "env": {
            "WIKIJS_URL": <your wikijs url>,
            "WIKIJS_API_KEY": <your wikijs api key>
        }
    }
  }
}

Streamable Http

Máquina Host

Inicie o servidor TRANSPORT_METHOD=streamable-http TRANSPORT_OPTIONS_PORT=8080 npx wikijs-mcp (Consulte Variáveis de Ambiente para todas as variáveis disponíveis)

IDE

{
  "mcpServers": {
    "wikijs-mcp": {
      "transport": "http-streamable",
      "name": "WikiJS MCP",
      "url": <your mcp host url with port>/mcp
    }
  }
}

Obtendo uma Chave de API WikiJS

1. Faça login na sua instância WikiJS como administrador
2. Vá para Administração > Acesso à API
3. Crie uma nova chave de API com as permissões apropriadas
4. Copie a chave gerada para o seu arquivo .env

Desenvolvimento

1. Clone o repositório:

git clone https://github.com/RicardoCenci/wikijs-mcp.git
cd wikijs-mcp

2. Instale as dependências:

npm install

3. Copie o modelo de ambiente e preencha seu conteúdo

cp env.example .env

4. Compile o projeto Se você tiver make instalado:

make build

5. Implante a instância WikiJS para testes

docker compose up -d

Uso

npx wikijs-mcp

Variáveis de Ambiente

Variável	Descrição	Obrigatória	Valores Permitidos	Padrão
WIKIJS_URL	URL da sua instância WikiJS	Sim	-	-
WIKIJS_API_KEY	Chave de API WikiJS	Sim	-	-
TRANSPORT_METHOD	O método de transporte	Não	stdio, streamable-http	stdio
TRANSPORT_OPTIONS_CORS_ORIGIN	Origem Cors (apenas em streamable-http)	Não	-	*
TRANSPORT_OPTIONS_CORS_HEADERS	Cabeçalhos Cors, separados por vírgula (apenas em streamable-http)	Não	-	Content-Type=mcp-session-id
TRANSPORT_OPTIONS_CORS_METHODS	Métodos Cors, separados por vírgula (apenas em streamable-http)	Não	-	GET,POST,OPTIONS
TRANSPORT_OPTIONS_SESSION_TIMEOUT_MS	Tempo limite de sessão (apenas em streamable-http)	Não	-	60000

Licença

Este projeto está licenciado sob a Licença MIT.