Bahrul
BahrulPersonal Docs

MCP Server Setup

Configure Model Context Protocol (MCP) servers for Claude Code and shadcn registries

This guide covers how to configure MCP (Model Context Protocol) servers for Claude Code by editing ~/.claude.json.

What is MCP?

MCP (Model Context Protocol) allows Claude Code to connect to external services and tools, extending its capabilities with web search, database access, UI components, and more.

Configuration

Edit your Claude Code configuration file:

# Open with your preferred editor
zed ~/.claude.json
# or
code ~/.claude.json
# or
nano ~/.claude.json

MCP Servers

Add the following mcpServers configuration to your ~/.claude.json:

~/.claude.json
{
  "mcpServers": {
    "exa": {
      "command": "bunx",
      "args": [
        "--bun",
        "mcp-remote",
        "https://mcp.exa.ai/mcp?tools=web_search_exa,get_code_context_exa,crawling_exa,company_research_exa,linkedin_search_exa,deep_researcher_start,deep_researcher_check&exaApiKey=YOUR_API_KEY"
      ]
    },
    "neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    },
    "shadcn": {
      "command": "bunx",
      "args": [
        "--bun",
        "shadcn@latest",
        "mcp"
      ]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    },
    "filesystem-mcp": {
      "command": "bunx",
      "args": [
        "--bun",
        "@sylphlab/filesystem-mcp"
      ],
      "name": "Filesystem (bunx)"
    },
    "kibo-ui": {
      "command": "bunx",
      "args": [
        "--bun",
        "mcp-remote",
        "https://www.kibo-ui.com/api/mcp/mcp"
      ]
    },
    "chrome-devtools": {
      "command": "bunx",
      "args": [
        "--bun",
        "chrome-devtools-mcp@latest"
      ]
    },
    "Astro docs": {
      "type": "http",
      "url": "https://mcp.docs.astro.build/mcp"
    }
  }
}

Replace YOUR_API_KEY with your actual API keys for Exa and Context7 services.

MCP Server Reference

ServerTypeDescription
exabunx/remoteWeb search, code context, crawling, company research, LinkedIn search
neonhttpNeon PostgreSQL database integration
shadcnbunxshadcn/ui component installation
context7httpContext7 documentation search
filesystem-mcpbunxFilesystem operations
kibo-uibunx/remoteKibo UI component library
chrome-devtoolsbunxChrome DevTools integration for debugging
Astro docshttpAstro framework documentation

Server Types

HTTP Type

Direct HTTP connection to MCP server:

{
  "neon": {
    "type": "http",
    "url": "https://mcp.neon.tech/mcp"
  }
}

With authentication headers:

{
  "context7": {
    "type": "http",
    "url": "https://mcp.context7.com/mcp",
    "headers": {
      "CONTEXT7_API_KEY": "YOUR_API_KEY"
    }
  }
}

Bunx Command Type

Run a local Bunx package:

{
  "shadcn": {
    "command": "bunx",
    "args": [
      "--bun",
      "shadcn@latest",
      "mcp"
    ]
  }
}

Bunx Remote Type

Use mcp-remote to connect to remote MCP servers:

{
  "kibo-ui": {
    "command": "bunx",
    "args": [
      "--bun",
      "mcp-remote",
      "https://www.kibo-ui.com/api/mcp/mcp"
    ]
  }
}

Shadcn Registries

For projects using shadcn/ui, you can configure additional component registries in your components.json:

components.json
{
  "$schema": "https://ui.shadcn.com/schema.json",
  "style": "base-lyra",
  "rsc": false,
  "tsx": true,
  "tailwind": {
    "config": "",
    "css": "src/index.css",
    "baseColor": "neutral",
    "cssVariables": true,
    "prefix": ""
  },
  "iconLibrary": "lucide",
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "ui": "@/components/ui",
    "lib": "@/lib",
    "hooks": "@/hooks"
  },
  "registries": {
    "@reui": "https://reui.io/r/{name}.json",
    "@formcn": "https://formcn.dev/r/{name}.json",
    "@abui": "https://abui.io/r/{name}.json",
    "@better-upload": "https://better-upload.com/r/{name}.json",
    "@assistant-ui": "https://r.assistant-ui.com/{name}.json",
    "@billingsdk": "https://billingsdk.com/r/{name}.json",
    "@coss": "https://coss.com/ui/r/{name}.json",
    "@diceui": "https://diceui.com/r/{name}.json",
    "@hextaui": "https://hextaui.com/r/{name}.json",
    "@kibo-ui": "https://www.kibo-ui.com/r/{name}.json",
    "@kokonutui": "https://kokonutui.com/r/{name}.json",
    "@lucide-animated": "https://lucide-animated.com/r/{name}.json",
    "@magicui": "https://magicui.design/r/{name}",
    "@manifest": "https://ui.manifest.build/r/{name}.json",
    "@plate": "https://platejs.org/r/{name}.json",
    "@react-bits": "https://reactbits.dev/r/{name}.json",
    "@shadcn-editor": "https://shadcn-editor.vercel.app/r/{name}.json",
    "@tour": "https://onboarding-tour.vercel.app/r/{name}.json",
    "@uitripled": "https://ui.tripled.work/r/{name}.json",
    "@wandry-ui": "https://ui.wandry.com.ua/r/{name}.json"
  }
}

Registry Reference

RegistryURLDescription
@reuireui.ioReUI components
@formcnformcn.devForm components
@abuiabui.ioAB UI components
@better-uploadbetter-upload.comFile upload components
@assistant-uiassistant-ui.comAI assistant UI
@billingsdkbillingsdk.comBilling components
@cosscoss.comCOSS UI
@diceuidiceui.comDice UI components
@hextauihextaui.comHexta UI components
@kibo-uikibo-ui.comKibo UI components
@kokonutuikokonutui.comKokonut UI
@lucide-animatedlucide-animated.comAnimated Lucide icons
@magicuimagicui.designMagic UI effects
@manifestmanifest.buildManifest UI
@plateplatejs.orgRich text editor
@react-bitsreactbits.devReact components
@shadcn-editorshadcn-editorCode editor
@touronboarding-tourOnboarding tours
@uitripledtripled.workTripled UI
@wandry-uiwandry.com.uaWandry UI

Installing from Registries

Use the shadcn CLI to install components from registries:

# Install from default registry
bunx shadcn@latest add button

# Install from custom registry
bunx shadcn@latest add @kibo-ui/kanban
bunx shadcn@latest add @magicui/bento-grid
bunx shadcn@latest add @plate/editor

Troubleshooting

Next Steps

On this page