description: MCP server for the Vielzeug ecosystem. Run over stdio or HTTP to expose package metadata, docs, source entrypoints, and Buildit component metadata. package: mcpit category: ai-tooling keywords: [mcp, model-context-protocol, ai-agent, claude, copilot, stdio, http, docs] related: [buildit, validit] exports: [createServer]

@vielzeug/mcpit

MCP server for the Vielzeug ecosystem. Run over stdio or HTTP to expose package metadata, docs, source entrypoints, and Buildit component metadata.

Package: @vielzeug/mcpit  ·  Category: AI Tooling

Key exports: createServer

When to use: You want AI clients to query Vielzeug docs and package metadata through a compact MCP tool set.

Related: @vielzeug/buildit · @vielzeug/validit

@vielzeug/mcpit is part of Vielzeug and ships with bundled snapshot data, so it runs without a local Vielzeug checkout.

Installation

pnpm add @vielzeug/mcpit
npm install @vielzeug/mcpit
yarn add @vielzeug/mcpit

Quick Start

Run over stdio (default):

npx -y @vielzeug/mcpit

Run over HTTP:

npx -y @vielzeug/mcpit --port 3100

Inspect CLI flags:

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

Tool API

| Tool | Input | Description | | --- | --- | --- | | list-packages | none | List all packages with metadata including availableDocPages and hasSource | | get-package | packageSlug | Get metadata for one package | | get-docs | packageSlug, page? | Read docs page (index, api, usage, examples) | | get-source | packageSlug | Read bundled src/index.ts text | | search-packages | query | Ranked search across metadata, keywords, docs, and source | | list-components | none | List @vielzeug/buildit component tags | | get-component | tagName | Get full Buildit component declaration by tag |

HTTP mode endpoints

• MCP endpoint: http://localhost:<port>/
• Health endpoint: http://localhost:<port>/health

Programmatic API

createServer(data) is exported for custom runtime wiring.

import { createServer } from '@vielzeug/mcpit';

// See docs for complete setup; this snippet documents the public symbol.
void createServer;

Documentation

• Overview
• Usage Guide
• API Reference
• Examples

License

MIT © Helmuth Saatkamp — part of the Vielzeug monorepo.