Januscope MCP Server

JanuScope is the local MCP policy proxy. One YAML wraps any MCP server with policy, redaction, audit, and database-schema injection. JanuScope runs locally, with no hosted gateway in the data path. Your upstream server and model provider can still receive data.

People who work with audit log, github and guardrails and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 30 · #48 OF 168 MAINTAINED DATABASE · VERIFIED 2026-09-18

AGPL-3.0 · TypeScript servers · how we verify → /methodology

01 · Install Januscope

before you install - you'll need

Set DATABASE_URI, MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB, MDB_MCP_CONNECTION_STRING, CLICKHOUSE_HOST, CLICKHOUSE_PORT, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD before connecting. CLICKHOUSE_DATABASE is optional or environment-specific per the README.

Claude Code

claude mcp add giancarloerra-januscope -- npx -y januscope

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "giancarloerra-januscope": {
      "command": "npx",
      "args": [
        "-y",
        "januscope"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license AGPL-3.0 - declared in the repository

npm package januscope - unscoped; check the name against the project README before installing

registry namespace io.github.giancarloerra is GitHub-verified and matches the repo owner

03 · What Januscope can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.5.0 · 2026-09-10

0.5.0 (2026-09-10) · run dependabot on Friday mornings · deps-dev: bump @types/node in the dev-dependencies group · deps-dev: bump @types/node in the dev-dependencies group · deps-dev: bump @types/pg in the…

v0.4.4 · 2026-06-02

0.4.4 (2026-06-02)

v0.4.3 · 2026-05-19

0.4.3 (2026-05-19)

04 · Who maintains Januscope

januscope is maintained by giancarloerra. We track 2 MCP servers from giancarloerra - 2 actively maintained, 3,342 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from giancarloerra.

  1. socraticode MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs. ★ 3,312

05 · Facts

category
database - ranked #48 of 168 actively-maintained database servers as of 2026-09-18.
release cadence
1 release in the last 90 days (latest 2026-09-10)
registry
io.github.giancarloerra/januscope (active, first published 2026-09-10)
packages
npm:januscope

06 · Januscope FAQ

What is Januscope?

JanuScope is the local MCP policy proxy. One YAML wraps any MCP server with policy, redaction, audit, and database-schema injection. JanuScope runs locally, with no hosted gateway in the data path. Your upstream server and model provider can still receive data.

Is Januscope still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 1 release in the last 90 days. We re-verify nightly.

How do I install Januscope?

Run `npx -y januscope`. The README documents 12 environment variables (DATABASE_URI, MYSQL_HOST, MYSQL_PORT…) to set first. Set DATABASE_URI, MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB, MDB_MCP_CONNECTION_STRING, CLICKHOUSE_HOST, CLICKHOUSE_PORT, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD before connecting. CLICKHOUSE_DATABASE is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Januscope run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Januscope