@indiekitai/mcp

Unified MCP server that auto-discovers and exposes all IndieKit tools through a single endpoint.

One config, all tools.

Quick Setup

Claude Desktop / Cursor:

{
  "mcpServers": {
    "indiekit": {
      "command": "npx",
      "args": ["@indiekitai/mcp"]
    }
  }
}

Or generate the config:

npx @indiekitai/mcp --config

Available Tools (16)

📊 PostgreSQL

| Tool | Package | Description | |------|---------|-------------| | pg_inspect_schema | @indiekitai/pg-inspect | Inspect database schema — tables, columns, indexes, constraints | | pg_diff_schemas | @indiekitai/pg-diff | Compare two databases and return migration SQL | | pg_diff_summary | @indiekitai/pg-diff | Human-readable diff summary | | pg_top_activity | @indiekitai/pg-top | Current pg_stat_activity | | pg_top_stats | @indiekitai/pg-top | Database statistics (connections, cache hit, TPS) | | pg_top_locks | @indiekitai/pg-top | Current lock information |

⚡ Development

| Tool | Package | Description | |------|---------|-------------| | just_list_recipes | @indiekitai/just | List justfile recipes | | just_run_recipe | @indiekitai/just | Execute a justfile recipe | | just_parse_justfile | @indiekitai/just | Parse justfile to AST | | throttled_check_rate | @indiekitai/throttled | Check rate limit status | | throttled_get_status | @indiekitai/throttled | Get rate limit state without consuming quota | | env_audit_scan | @indiekitai/env-audit | Scan project for environment variables | | llm_context_scan | @indiekitai/llm-context | Count tokens for LLM context estimation |

🎨 Terminal UI

| Tool | Package | Description | |------|---------|-------------| | lipgloss_style_render | @indiekitai/lipgloss | Render styled terminal text | | lipgloss_join_horizontal | @indiekitai/lipgloss | Join text blocks horizontally | | lipgloss_join_vertical | @indiekitai/lipgloss | Join text blocks vertically |

CLI

npx @indiekitai/mcp            # Start MCP server (stdio)
npx @indiekitai/mcp --list     # List all tools
npx @indiekitai/mcp --config   # Claude Desktop config JSON

Auto-Discovery

The server automatically discovers additional tools from installed @indiekitai/* packages that export MCP tool definitions:

1. Scans node_modules/@indiekitai/*/package.json
2. Checks for exports["./mcp"] or indiekit.mcp: true in package.json
3. Dynamically imports and registers discovered tools

Adding Tools to Your Package

Export a getTools() function from your package's MCP module:

// src/mcp.ts
import type { ToolDefinition } from '@indiekitai/mcp';

export function getTools(): ToolDefinition[] {
  return [{
    name: 'my_tool',
    description: 'Does something useful',
    package: '@indiekitai/my-package',
    mode: 'direct',
    inputSchema: {
      type: 'object',
      properties: {
        input: { type: 'string', description: 'Input value' },
      },
      required: ['input'],
    },
    handler: async (params) => {
      // Tool implementation
      return { result: 'done' };
    },
  }];
}

Then add to your package.json:

{
  "exports": {
    "./mcp": "./dist/mcp.js"
  }
}

License

MIT