Koma Core MCP — Claude Code MCP server
This MCP server exposes protected RAG storage to agents: they can find public metadata and fetch full text only with the required access tier.
claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpWhat Koma Core MCP does
Koma Core MCP exposes two tools to an agent. search_docs filters the public index by category or tag and returns fields such as displayName, accessTier, and preview. It does not reveal document text. retrieve_doc uses a sourceId from the search result to request the full document.
The server checks the requested userTier against each document tier. Supported values are public, premium, and enterprise. Three demo documents are loaded when the process starts, and the storage stays in memory between requests.
For production, the reference setup needs a real database behind DatabaseAdapter and a real master key. KOMA_MASTER_KEY can be supplied at launch; otherwise the server uses its demo key, so this setup is suited to testing the access boundary rather than persistent storage.
What it helps with
- search documents by category or tag
- return metadata without exposing content
- fetch a document from its
sourceId - check access against a user tier
Example prompts for the agent
- Use
search_docsto find documents taggedapiand show their metadata. - Call
retrieve_docforapi-referencewith thepremiumuser tier. - Check whether a
publicuser can accessinternal-architecture.
How to install Koma Core MCP
Platform CLI
claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpReplace <…> with your own values
Platform CLI
codex mcp add koma-core-mcp --env KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"koma-core-mcp": {
"command": "npx",
"args": [
"-y",
"koma-core-mcp"
],
"env": {
"KOMA_MASTER_KEY": "<KOMA_MASTER_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"koma-core-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"koma-core-mcp"
],
"env": {
"KOMA_MASTER_KEY": "<KOMA_MASTER_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> koma-core-mcp npx -y koma-core-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Koma Core MCP
How do I install Koma Core MCP in Claude Code?
Run claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcp.
What does Koma Core MCP do?
It connects an agent to protected RAG storage through MCP. Search exposes metadata, while document text is returned only after the access tier is checked.
How does Koma Core MCP enforce document access?
retrieve_doc compares userTier with the document tier. internal-architecture requires enterprise, while guide-getting-started is available at public.
