Kibela

mcp-kibela 🗒️

Uma implementação de servidor Model Context Protocol (MCP) que permite que assistentes de IA pesquisem e referenciem conteúdo do Kibela. Esta configuração permite que modelos de IA como o Claude acessem com segurança informações armazenadas no Kibela.

Recursos 🚀

O servidor mcp-kibela fornece os seguintes recursos:

• Pesquisa de Notas: Pesquise notas do Kibela por palavras-chave
• Minhas Notas: Obtenha suas notas mais recentes
• Conteúdo da Nota: Obtenha o conteúdo e comentários da nota por ID
• Nota por Caminho: Obtenha o conteúdo da nota por caminho
• Criar Nota: Crie uma nova nota
• Atualizar Conteúdo da Nota: Atualize o conteúdo da nota pelo ID da nota

---

Pré-requisitos 📋

Antes de começar, certifique-se de ter:

• Node.js (v18 ou superior)
• Cliente MCP (Claude Desktop, Cursor, etc.)
• Token de Acesso do Kibela (Como obter um token)
• Git (se estiver compilando a partir do código-fonte)

Instalação 🛠️

Uso com Cursor

{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

Uso com VSCode

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

Uso com Claude Desktop

{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

Usando Smithery

npx -y @smithery/cli install @kj455/mcp-kibela --client claude

Variáveis de Ambiente

As seguintes variáveis de ambiente são necessárias:

• KIBELA_TEAM: O nome da sua equipe Kibela (obrigatório). Você pode encontrá-lo na URL da página da sua equipe Kibela. Ex.: https://[team-name].kibe.la
• KIBELA_TOKEN: Seu token de API do Kibela (obrigatório)

Contribuindo

Quaisquer contribuições são bem-vindas!

Desenvolvimento

1. Use npm run build:watch para compilar o projeto em modo de observação.

npm run build:watch

2. Use npx @modelcontextprotocol/inspector para inspecionar o servidor MCP.

npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

Licença 📄

MIT