MCP server for continuous OpenCode discussion sessions
Project description
OpenCode Bridge
MCP server for continuous discussion sessions with OpenCode. Collaborate with GPT-5, Claude, Gemini, and other models through Claude Code.
Quick Start
# 1. Install
uv pip install git+https://github.com/genomewalker/opencode-bridge.git
# 2. Register with Claude Code
opencode-bridge-install
# 3. Use in Claude Code
# The tools are now available - Claude will use them automatically
Features
- Continuous sessions: Conversation history persists across messages
- Multiple models: Access all OpenCode models (GPT-5.x, Claude, Gemini, etc.)
- Agent support: plan, build, explore, general agents
- Variant control: Set reasoning effort (minimal → max)
- File attachment: Share code files for review
- Session continuity: Conversations continue across tool calls
Installation
With uv (recommended)
uv pip install git+https://github.com/genomewalker/opencode-bridge.git
With pip
pip install git+https://github.com/genomewalker/opencode-bridge.git
From source
git clone https://github.com/genomewalker/opencode-bridge.git
cd opencode-bridge
pip install -e .
Register with Claude Code
# Install (registers MCP server)
opencode-bridge-install
# Verify
claude mcp list
# Uninstall
opencode-bridge-uninstall
Available Models
| Provider | Models |
|---|---|
| openai | gpt-5.2-codex, gpt-5.1-codex-max, gpt-5.1-codex-mini |
| github-copilot | claude-opus-4.5, claude-sonnet-4.5, gpt-5, gemini-2.5-pro |
| opencode | gpt-5-nano (free), glm-4.7-free, grok-code |
Run opencode models to see all available models.
MCP Tools
| Tool | Description |
|---|---|
opencode_start |
Start a new session |
opencode_discuss |
Send a message |
opencode_plan |
Start planning discussion |
opencode_brainstorm |
Open-ended brainstorming |
opencode_review |
Review code |
opencode_models |
List available models |
opencode_agents |
List available agents |
opencode_model |
Change session model |
opencode_agent |
Change session agent |
opencode_variant |
Change reasoning effort |
opencode_config |
Show current configuration |
opencode_configure |
Set defaults (persisted) |
opencode_history |
Show conversation history |
opencode_sessions |
List all sessions |
opencode_switch |
Switch to another session |
opencode_end |
End current session |
opencode_health |
Server health check |
Configuration
Environment variables
export OPENCODE_MODEL="openai/gpt-5.2-codex"
export OPENCODE_AGENT="plan"
export OPENCODE_VARIANT="medium"
Config file
~/.opencode-bridge/config.json:
{
"model": "openai/gpt-5.2-codex",
"agent": "plan",
"variant": "medium"
}
Variants (reasoning effort)
minimal → low → medium → high → xhigh → max
Higher variants use more reasoning tokens for complex tasks.
Requirements
- Python 3.10+
- OpenCode CLI installed
- Claude Code
License
MIT
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file opencode_bridge-0.4.3.tar.gz.
File metadata
- Download URL: opencode_bridge-0.4.3.tar.gz
- Upload date:
- Size: 87.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
37d5defdba8e18a3419f498507412fd56df371c13285cd92e90d24578f88f835
|
|
| MD5 |
06d35f2f7041daf3d539df9cffe07919
|
|
| BLAKE2b-256 |
0b34b7010ef56e1cfcd9f2cf55426bf681ddc8b62ce2f92b4f5ccf7dde11708e
|
File details
Details for the file opencode_bridge-0.4.3-py3-none-any.whl.
File metadata
- Download URL: opencode_bridge-0.4.3-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be5f76a01e5d4e43bdf8397e6f7fc1aeadb9d16aea99410692635a27a5cdb46d
|
|
| MD5 |
6d11252d830c8e5abd262212ca03bf9c
|
|
| BLAKE2b-256 |
0bef8b1c4566f5076c508a498c2e0fe006dbd1d2f3894ce4c4900e2f0cd08084
|