Koma Core MCP Server

by swnotmetalio.github.swnotmetal/koma-core-mcpv0.1.1

Protected RAG storage — agents discover public metadata, content only by access token.

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Koma Core MCP server

claude mcp add koma-core -e KOMA_MASTER_KEY='<koma-master-key>' -- npx -y koma-core-mcp

{
  "mcpServers": {
    "koma-core": {
      "command": "npx",
      "args": [
        "-y",
        "koma-core-mcp"
      ],
      "env": {
        "KOMA_MASTER_KEY": "<koma-master-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "koma-core": {
      "command": "npx",
      "args": [
        "-y",
        "koma-core-mcp"
      ],
      "env": {
        "KOMA_MASTER_KEY": "<koma-master-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "koma-core": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "koma-core-mcp"
      ],
      "env": {
        "KOMA_MASTER_KEY": "<koma-master-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "koma-core": {
      "command": "npx",
      "args": [
        "-y",
        "koma-core-mcp"
      ],
      "env": {
        "KOMA_MASTER_KEY": "<koma-master-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
KOMA_MASTER_KEY	—	yes	HKDF master key for content tokens (demo key fallback if unset)

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
2026-08-11 · 59d ago · GitHub · v0.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-15 · 55d ago · official registry · v0.1.1

FAQ

›How do I install the Koma Core MCP server in Claude Code?

Run: claude mcp add koma-core -e KOMA_MASTER_KEY='<koma-master-key>' -- npx -y koma-core-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Koma Core require an API key?

Yes. It expects KOMA_MASTER_KEY, of which 1 is a secret.

›Can I use Koma Core as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Koma Core in the official MCP registry?

Yes, as io.github.swnotmetal/koma-core-mcp.