convez.ai
MCP ServerIntegração & APIsIntermediário
hebbianvault

Hebbian MCP Server

hebbianvault/hebbian-mcp

Cliente MCP minimalista para integração com Hebbian tenant brain

Ver no GitHub
BomPluginScore · de 0 a 100

Adaptador MCP que conecta Claude Code, Claude Desktop, Cursor e agentes compatíveis à sua API Hebbian. Cliente minimalista e auditável que expõe 9 ferramentas para leitura, busca, captura e contextualização de conhecimento armazenado no seu workspace Hebbian.

Instalação

$npx convez-ai hebbianvault/hebbian-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 5 dias
Versão
v0.6.0
Issues abertas
10
Contribuidores
2

Casos de uso

  • Conectar Claude e outros agentes MCP ao workspace Hebbian
  • Buscar e recuperar conhecimento de forma contextualizada em tempo real
  • Capturar notas e insights diretamente do agente para o workspace

Veredito

Integração limpa e auditável entre ecossistema Claude/MCP e plataforma Hebbian. Código minimalista (sem lógica de negócio) que delega controle de acesso ao serviço Hebbian via token. Ideal para quem usa Hebbian como camada de conhecimento pessoal ou corporativo.

README

A tradução para o português deste README ainda está na fila.

hebbian-mcp

npm PyPI License

Customer-installable adapter that connects Claude Code, Claude Desktop, Cursor, and any MCP-compatible agent to your Hebbian workspace.

The adapter is a thin client. Your token goes in; the Hebbian service decides what you can read and write. This package contains no business logic — it is intentionally small and auditable before you paste a credential.

Install

Both packages are published and expose the same 9 tools and the same configuration. Use whichever matches your MCP host.

# Node.js (npm) — run directly, no global install needed
npx @hebbianvault/mcp

# Python (PyPI)
pip install hebbianvault-mcp   # or: uv pip install hebbianvault-mcp

See Quick start (TypeScript) and Quick start (Python) below for adding the server to your MCP host and generating a token.

Packages

PackageLanguageInstall
@hebbianvault/mcpTypeScript / Node.jsnpm install -g @hebbianvault/mcp
hebbianvault-mcpPythonpip install hebbianvault-mcp

Both expose the same 9 tools and the same configuration. Use whichever matches your MCP host.

Quick start (TypeScript)

npm install -g @hebbianvault/mcp

Generate a token from your Hebbian integrations page (AI Tools tab → Generate token), then add the server to your MCP host.

Claude Code

claude mcp add hebbian \
  -e HEBBIAN_API_TOKEN=your_token_here \
  -- npx -y @hebbianvault/mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "hebbian": {
      "command": "npx",
      "args": ["-y", "@hebbianvault/mcp"],
      "env": {
        "HEBBIAN_API_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "hebbian": {
      "command": "npx",
      "args": ["-y", "@hebbianvault/mcp"],
      "env": {
        "HEBBIAN_API_TOKEN": "your_token_here"
      }
    }
  }
}

Quick start (Python)

pip install hebbianvault-mcp
# or with uv (preferred)
uv add hebbianvault-mcp
HEBBIAN_API_TOKEN=your_token_here hebbian-mcp

Token scope

Your token determines what the adapter can see and do — a personal-workspace token gives access to your own knowledge; a company-workspace token gives access to the shared company workspace (where your role allows). Scope is decided by the Hebbian service, not by this package.

Generate, name, and revoke tokens from the AI Tools tab of your Hebbian integrations page. Never commit tokens to git.

Tools

ToolWhat it does
hebbian_read_nodeRead a single node by UUID (content, metadata, connected edges)
hebbian_searchFind nodes in your workspace matching a query
hebbian_askAsk a question and get an answer backed by source quotes
hebbian_contextDescribe a task and a token budget, get back a salience-ranked context pack that fits
hebbian_captureWrite a note into your workspace
hebbian_traverseExplore nodes connected to a starting node
hebbian_provenanceSee where a node's knowledge came from
hebbian_salienceSee a node's recent activity over time
hebbian_recent_activityCatch up on recent changes in your workspace

All access control is decided by the Hebbian service; results only ever include what your token is allowed to see.

Configuration

VariablePurpose
HEBBIAN_API_TOKENYour token (required). HEBBIAN_TOKEN is also accepted.
HEBBIAN_API_URLOverride the API base URL (Enterprise self-host). Defaults to the Hebbian SaaS API.
HEBBIAN_TENANTOptional workspace slug — only needed if your account belongs to more than one workspace.

Config file (alternative)

Write ~/.config/hebbian/mcp-tenant.json:

{
  "token": "your_token_here"
}

Enterprise self-host customers add "api_url": "https://api.your-hebbian-host.example" (or set HEBBIAN_API_URL) to point the adapter at their own deployment.

Security

  • Tokens are bearer credentials — treat them like passwords.
  • Never commit tokens to git. Use env vars or a config file outside your repo.
  • A 401 response means your token is expired or revoked — generate a new one from the AI Tools tab.
  • HTTPS-only transport.
  • The adapter source is public so you can audit exactly what runs on your machine before pasting a credential. All access control is enforced by the Hebbian service.

Source layout

ts/    — TypeScript package (@hebbianvault/mcp, npm)
py/    — Python package (hebbianvault-mcp, PyPI)

Development

TypeScript

cd ts/
npm install
npm run build
npm test

Python

cd py/
uv venv && uv pip install -e ".[dev]"
pytest
ruff check src/ tests/

Contributing

See CONTRIBUTING.md.

License

Apache-2.0. See LICENSE.

The Hebbian service this adapter connects to is proprietary. This adapter is the open-source reference client.

Ver o original no GitHub

Bom para

Relacionados