Skip to main content

bub-mcp-server

Expose Bub as an SSE MCP server.

What It Provides

  • Channel implementation: MCPServerChannel (name = "mcp-server")
  • FastMCP SSE server lifecycle managed by Bub channel startup and shutdown
  • One MCP tool: run_model

Tool

run_model accepts:

  • prompt (required): input text to send through Bub
  • session_id (optional): Bub session id, default mcp:default

It returns Bub's model_output for that turn.

Configuration

Settings are read from environment variables with the BUB_MCP_SERVER_ prefix.

  • BUB_MCP_SERVER_HOST: bind host, default 127.0.0.1
  • BUB_MCP_SERVER_PORT: bind port, default 28280 (BUBU0 on 9-keyboard)
  • BUB_MCP_SERVER_PATH: SSE path, default /sse
  • BUB_MCP_SERVER_LOG_LEVEL: Uvicorn log level, default info

Installation

uv pip install bub-mcp-server

In this repository, the package is included in the workspace and root dependencies.

Usage

Start Bub with channels enabled. The MCP SSE endpoint is available at:

http://127.0.0.1:28280/sse

Configure your MCP client to use SSE transport against that URL.

Metadata

Release files for bub-mcp-server 0.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bub-mcp-server 0.0.2
File Size Uploaded
bub_mcp_server-0.0.2.tar.gz 2.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bub-mcp-server 0.0.2
File Interpreter ABI Platform
bub_mcp_server-0.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 7.0 kB

Release files / bub_mcp_server-0.0.2.tar.gz

Download URL bub_mcp_server-0.0.2.tar.gz
Size 2.9 kB
Tags Source
SHA-256 checksum
How to use checksums
645b9e9edc6590ffc6f19fee506a2ce1579aee5ff90728c81a3f2e70c0dc6b0f
BLAKE2b-256 checksum
How to use checksums
e1378f70aa255195c477a7d796df3bc76255574cd0982c7520245f9e89198557
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / bub_mcp_server-0.0.2-py3-none-any.whl

Download URL bub_mcp_server-0.0.2-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8d63b4db089b6b08c9344b9a4e556c029db3851fa483babd640aafaccfd06d49
BLAKE2b-256 checksum
How to use checksums
372f6195e4a1e159005fc1fa70018d23be25ad981c5d6fa6720e9d352f2bdc05
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page