Skip to main content

Expose Bub as an SSE MCP server

Project description

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 "git+https://github.com/bubbuild/bub-contrib.git#subdirectory=packages/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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bub_mcp_server-0.0.1.tar.gz (2.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bub_mcp_server-0.0.1-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

Details for the file bub_mcp_server-0.0.1.tar.gz.

File metadata

  • Download URL: bub_mcp_server-0.0.1.tar.gz
  • Upload date:
  • Size: 2.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","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}

File hashes

Hashes for bub_mcp_server-0.0.1.tar.gz
Algorithm Hash digest
SHA256 7ae9d09fbe9d5c34712996be2e8cc7ea957ddda21f7ee92d7a21873bbaa788ae
MD5 b44bb30efa96ab3738b93fa28ca43fe6
BLAKE2b-256 0911b6d4d2ef38c76701a0b463e79157aaf9c38f51dfc5d40f15a9902a5ae823

See more details on using hashes here.

File details

Details for the file bub_mcp_server-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: bub_mcp_server-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 4.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","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}

File hashes

Hashes for bub_mcp_server-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ba177c6514487823d49787d270da040c62ba5e09200e75ce4f611938fa7bfb58
MD5 cbe4baa8edcd433c22f18adb0ad7ae1d
BLAKE2b-256 c50bfcef1d9b3fe0a7faf778047e1a4625b951a4a8615917e0cedd10755d67bd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page