MCP Directory

How to add KoliBri MCP Server to Windsurf

Give AI agents access to 200+ accessible KoliBri Web Component samples, specs, and docs over MCP. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 268★ · http · no auth · official

Windsurf config for KoliBri MCP Server

npm install -g @public-ui/mcp
{
  "mcpServers": {
    "kolibri-mcp-server": {
      "serverUrl": "https://public-ui-kolibri-mcp.vercel.app/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the KoliBri MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5KoliBri MCP Server's tools become available to Cascade.

Before you start

  • An MCP-compatible client (e.g. Claude Desktop, VS Code Copilot)
  • For local stdio transport: Node.js with npx, or a global install of @public-ui/mcp

What KoliBri MCP Server can do in Windsurf

hello_kolibri

A simple greeting tool for testing the connection and getting server metadata. Optional `name` (string) parameter to greet.

search

Search KoliBri component samples, scenarios, and documentation using fuzzy search (Fuse.js). Optional params: `query` (string, empty returns all), `kind` ("doc" | "sample" | "scenario"), `limit` (number, default 10).

fetch

Get a specific sample or documentation entry by its ID. Required param: `id` (string, e.g. "button/basic").

Security

The hosted remote endpoint requires no authentication and serves public KoliBri component documentation. Optional request logging can be enabled with the MCP_LOGGING environment variable (disabled by default); in stdio mode logs are written to stderr so they do not interfere with the JSON-RPC protocol on stdout.

KoliBri MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the KoliBri MCP Server config there under the "mcpServers" key and restart the client.

Is KoliBri MCP Server safe to use with Windsurf?

The hosted remote endpoint requires no authentication and serves public KoliBri component documentation. Optional request logging can be enabled with the MCP_LOGGING environment variable (disabled by default); in stdio mode logs are written to stderr so they do not interfere with the JSON-RPC protocol on stdout.

Do I need to install anything to use it?

No. The recommended setup is the hosted remote HTTP endpoint at https://public-ui-kolibri-mcp.vercel.app/mcp, which requires zero installation and stays up-to-date with the latest samples. A local stdio install via npm or npx is available as an alternative.

What transports are supported?

A remote StreamableHTTP endpoint (POST /mcp) as the primary/recommended option, and a local stdio transport via the kolibri-mcp binary (or npx @public-ui/mcp) for offline use, local development, and self-hosting.

Does it require authentication or an API key?

No. The server serves public KoliBri component documentation and requires no authentication.

View repo Full KoliBri MCP Server page