1. Conduid
  2. Developer Tools
  3. bun-server
MCP server · Developer Tools

bun-server

by · github.com/chikingsley/bun-mcp-server

template for Bun + MCP server project

Unclaimed devtools
InstallView source
39Low

Scored 2 months ago · breakdown

About bun-server

bun-server is an MCP server published by git+chikingsley in the Developer Tools category: template for Bun + MCP server project.

Install

Install
npx bun-mcp-server
Claude Code
claude mcp add bun-mcp-server -- npx -y bun-mcp-server
npx
npx -y bun-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

grep_bun_docsJavaScript regex pattern matching

Parameters not published.

list_bun_docsBrowse docs by category

Parameters not published.

read_bun_docRead markdown documentation by slug (paginated)

Parameters not published.

search_bun_docsFull-text search with SQLite FTS5 + BM25 ranking

Parameters not published.

Ask AI

✦

Ask AI about bun-server

Powered by Claude · Grounded in docs

I know everything about bun-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

Bun Documentation MCP + Claude Code Plugin

A Model Context Protocol (MCP) server and Claude Code plugin that makes Claude a Bun expert. Provides intelligent access to Bun documentation with full-text search, plus skills, commands, and hooks that proactively guide you toward Bun-native APIs.

What's Included

MCP Server (4 tools)

Tool Description
search_bun_docs Full-text search with SQLite FTS5 + BM25 ranking
grep_bun_docs JavaScript regex pattern matching
read_bun_doc Read markdown documentation by slug (paginated)
list_bun_docs Browse docs by category

Claude Code Plugin

Component Description
3 Skills Pre-loaded knowledge: Bun-native APIs, Node-to-Bun migration recipes, testing/bundling/package management
1 Agent bun-optimizer - proactively scans JS/TS files for Node.js patterns that should be Bun-native
2 Commands /bun-docs:bun-check (audit project) and /bun-docs:bun-migrate (migrate a package/file)
1 Hook Intercepts bun add express (and 40+ other packages) with Bun-native alternative warnings

Installation

As a Claude Code Plugin (recommended)

# Add the marketplace
/plugin marketplace add chikingsley/bun-mcp-server

# Install the plugin
/plugin install bun-docs@bun-plugins

This gives you everything: MCP tools, skills, commands, agent, and hooks.

MCP Server Only

If you just want the documentation search tools:

claude mcp add bun-docs bunx bun-mcp-server

Local Plugin (for development)

# Symlink into your global plugins directory
mkdir -p ~/.claude/plugins
ln -s /path/to/bun-doc-mcp ~/.claude/plugins/bun-docs

Usage

Skills (automatic)

Just ask questions - Claude automatically activates the right skill:

  • "How do I create an HTTP server in Bun?" (activates bun-apis skill)
  • "Migrate this Express app to Bun" (activates bun-migration skill)
  • "How do I write tests with bun:test?" (activates bun-testing skill)

Commands

/bun-docs:bun-check              # Scan project for Node.js anti-patterns
/bun-docs:bun-check package.json # Audit specific file
/bun-docs:bun-migrate express    # Migrate a specific package to Bun-native
/bun-docs:bun-migrate src/db.ts  # Migrate a specific file

Hook (automatic)

When Claude runs bun add express, bun add pg, bun add ws, or any of 40+ Node.js packages, you'll see a warning like:

Bun Alternative Available express has a Bun-native replacement: Bun.serve()

Agent (automatic)

After Claude writes or edits JS/TS files, the bun-optimizer agent can proactively scan for Node.js patterns and suggest Bun-native replacements.

Packages Intercepted by Hook

Web Frameworks: express, koa, hapi, fastify, polka, micro Database: pg, postgres, better-sqlite3, ioredis, redis WebSocket: ws, socket.io, engine.io HTTP: node-fetch, cross-fetch, axios, got, ky, superagent Shell: execa, shelljs, cross-spawn Files: glob, fast-glob, globby, fs-extra, chokidar Env: dotenv, dotenv-expand Crypto: bcrypt, bcryptjs, argon2 Testing: jest, vitest, mocha, chai, jasmine Bundler: webpack, esbuild, rollup, parcel, tsup

Development

bun install
bun run build
bun run test
bun run lint
bun run typecheck

How the MCP Server Works

  1. Downloads Bun docs from GitHub (matching your Bun version) via sparse checkout
  2. Builds SQLite FTS5 search index with BM25 ranking
  3. Caches docs and index in ~/.cache/bun-mcp-server/{version}/
  4. Serves search, read, and browse tools over stdio

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About bun-server

How do I install bun-server?

Run npx bun-mcp-server, then add the server to your MCP client's configuration.

Is bun-server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is bun-server still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.