• Quick setup (standalone)
• Quick setup (monorepo development)
• Transport modes
  • Stdio (default)
  • HTTP / Streamable HTTP (--port)
• Connect Claude Desktop
• Connect GitHub Copilot Chat
  • Stdio
  • HTTP
• Recommended tool workflow
• Keeping bundled data fresh (monorepo)

New to Mcpit?

Start with the Overview, then use this page for setup and client configuration.

Quick setup (standalone)

@vielzeug/mcpit ships with bundled snapshot data, so no Vielzeug checkout is required for normal use.

npx -y @vielzeug/mcpit

HTTP mode:

npx -y @vielzeug/mcpit --port 3100

CLI helpers:

npx -y @vielzeug/mcpit --help
npx -y @vielzeug/mcpit --version

Quick setup (monorepo development)

Use this mode only when developing mcpit itself.

cd /path/to/vielzeug/packages/mcpit
pnpm build
pnpm test
node dist/cli.js

Transport modes

Stdio (default)

The MCP server communicates over stdin/stdout and is ideal for local clients such as Claude Desktop and Copilot Chat.

HTTP / Streamable HTTP (--port)

Run with --port <number> to expose an HTTP endpoint for remote agents.

npx -y @vielzeug/mcpit --port 3100

HTTP endpoints:

• MCP endpoint: http://localhost:3100/
• Health endpoint: http://localhost:3100/health

Connect Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vielzeug": {
      "command": "npx",
      "args": ["-y", "@vielzeug/mcpit"]
    }
  }
}

Connect GitHub Copilot Chat

Create or extend .vscode/mcp.json in your workspace root.

Stdio

{
  "servers": {
    "vielzeug": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vielzeug/mcpit"]
    }
  }
}

HTTP

{
  "servers": {
    "vielzeug": {
      "type": "http",
      "url": "http://localhost:3100/"
    }
  }
}

Recommended tool workflow

Typical AI-agent flow:

1. list-packages to inspect package catalog and available pages
2. search-packages to find relevant packages by capability
3. get-package for structured metadata of the selected package
4. get-docs with page: "usage", "api", or "examples" for docs
5. get-source for src/index.ts

For Buildit component queries:

1. list-components
2. get-component

Keeping bundled data fresh (monorepo)

Bundled data is regenerated before build and test in packages/mcpit.

Manual refresh:

cd /path/to/vielzeug/packages/mcpit
pnpm run prepare:data

If Buildit component metadata is missing in results, build @vielzeug/buildit first so packages/buildit/dist/custom-elements.json is available when bundling.