@moxn/mcp-kb

MCP (Model Context Protocol) client for Moxn Knowledge Base. Connects Claude Code to your Moxn workspace via stdio transport.

Installation

npm install -g @moxn/mcp-kb

Or use directly with npx:

npx @moxn/mcp-kb --workspace=your-workspace-slug

Configuration

Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "moxn-kb": {
      "command": "npx",
      "args": ["-y", "@moxn/mcp-kb", "--workspace=your-workspace-slug"]
    }
  }
}

Authentication

On first run, the client will:

1. Register an OAuth client with Clerk (Dynamic Client Registration)
2. Open your browser to authenticate
3. Store credentials in ~/.moxn/credentials.json

Subsequent runs use the stored credentials automatically.

Environment Variables

| Variable | Description | |----------|-------------| | MOXN_TOKEN | Skip OAuth flow and use this token directly | | MOXN_WORKSPACE | Default workspace (alternative to --workspace flag) | | MOXN_BASE_URL | Override API URL (for local development) | | MOXN_AUTH_SERVER | Override auth server URL (for local development) |

Available Tools

Once connected, Claude Code has access to these Knowledge Base tools:

• find - List documents, sections, or folders
• read - Read document/section content
• documents - Create, update, delete documents; manage branches and tags
• sections - Create, update, delete, reorder sections
• search - Search content across the knowledge base

Development

# Clone the repo
git clone https://github.com/moxn-ai/moxn.git
cd moxn/packages/mcp-kb

# Install dependencies
npm install

# Build
npm run build

# Test locally
node dist/index.js --workspace=your-workspace-slug

License

MIT