Bun-based MCP Server

Name: Bun-based MCP Server
Author: moikas-code

@moikas-code

Repository

About Bun-based MCP Server

No overview available yet

#mcp-server #bun #typescript

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-moikas-code": {
      "command": "bun",
      "args": [
        "run",
        "src/index.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Bun-based MCP Server?

Bun-based MCP Server is a minimal Model Context Protocol (MCP) server implemented with Bun, TypeScript, and the @modelcontextprotocol/sdk package. It demonstrates basic MCP functionality including a sample tool (add) for adding two numbers and dynamic tool loading from a (mocked) PostgreSQL database.

How to use Bun-based MCP Server?

Install Bun, then run bun install to install dependencies. Start the server with bun run src/index.ts; it listens for MCP requests via stdio. Lint with bun run lint and type-check with bun run tsc.

Key features of Bun-based MCP Server

Minimal MCP server built with Bun and TypeScript
Uses StdioServerTransport for local testing
Strict TypeScript and ESLint configuration
Example add tool (returns sum of two numbers)
Dynamic tool loading simulated from a PostgreSQL database

Use cases of Bun-based MCP Server

Learning how to build an MCP server with Bun
Rapid prototyping of MCP tools before production deployment
Testing MCP integrations locally via stdio transport
Exploring dynamic tool registration from a database

FAQ from Bun-based MCP Server

What runtime does Bun-based MCP Server require?

It requires Bun as the JavaScript runtime.

How does the server handle MCP requests?

It uses StdioServerTransport, meaning it communicates over standard input/output for local testing.

Can I add my own tools to the server?

Yes. The function load_tools_from_db in src/index.ts is a placeholder that simulates loading tool definitions and handlers from a PostgreSQL database. Replace its implementation with real database logic to add your own tools.