@virtualsnake9/themis-mcp

Servidor MCP (stdio) para conectar Cursor y agentes al motor de políticas Themis (repo privado).

Paquete npm: @virtualsnake9/themis-mcp (org @virtualsnake9).

Gestiona roles, bindings de recursos y evaluación de acceso vía HTTP al API Themis (THEMIS_API_BASE_URL).

Instalación (consumidores)

Cursor — mcp.json

{
  "mcpServers": {
    "themis": {
      "command": "npx",
      "args": ["-y", "@virtualsnake9/themis-mcp"],
      "env": {
        "THEMIS_API_BASE_URL": "http://localhost:3001"
      }
    }
  }
}

Ver también .cursor/mcp.json.example.

Global (opcional)

npm install -g @virtualsnake9/themis-mcp

Primer publish en npm

Los paquetes se publican bajo @virtualsnake9. Secret NPM_TOKEN en GitHub con permiso publish en esa org.

Primer uso

1. Levantar Themis API (:3001)
2. En Cursor, llamar tool themis_login (device flow → /device en admin Themis)
3. Usar tools de políticas (themis_member_add_role, themis_resource_bind, etc.)

Token persistido en ~/.themis-mcp/token.

Tools principales

| Tool | Uso | |------|-----| | themis_login | Sesión (obligatorio primero) | | themis_resource_access | ¿Usuario puede acceder a recurso? | | themis_member_add_role / themis_member_remove_role | Roles por email | | themis_resource_bind / themis_resource_unbind | Restringir recurso | | themis_check_permission | Permiso global |

Variables de entorno

| Variable | Requerido | Descripción | |----------|-----------|-------------| | THEMIS_API_BASE_URL | Sí | URL API Themis | | THEMIS_API_TOKEN | No | Token manual (alternativa a login) | | THEMIS_TOKEN_FILE | No | Ruta token (default ~/.themis-mcp/token) |

Publicar en npm (automático)

Secret GitHub: NPM_TOKEN

Settings → Secrets → Actions → NPM_TOKEN (token npm con publish).

Release

# version en package.json = 0.1.0
git tag v0.1.0
git push origin main --tags

Workflow publish.yml publica al pushear tag v*.

Manual

npm run build && npm publish --access public

Repos relacionados

| Repo | Qué es | |------|--------| | themis | API + admin | | themis-sdk | @virtualsnake9/themis-sdk para backends | | themis-mcp | Este repo |

Desarrollo

npm install
npm run build
node dist/index.js

Guía agentes: AGENTS.md