convez.ai
MCP ServerIntegração & APIsAvançado
a9lim

Gaslamp

a9lim/gaslamp

Ponte MCP bidirecional entre Claude e Codex

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server minimalista que estabelece ponte bidirecional entre Claude e Codex, permitindo que ambos os CLIs se comuniquem e consultem um ao outro. Funciona como camada de integração para ampliar capacidades de ambas as ferramentas através do protocolo MCP.

Instalação

$npx convez-ai a9lim/gaslamp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 3 semanas
Versão
v3.0.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar Claude a partir do fluxo do Codex
  • Estender capacidades do Codex com acesso às ferramentas do Claude
  • Automação de workflows que requerem ambos os agentes

Veredito

Projeto técnico sofisticado para usuários avançados que dominam ambos CLIs. Resolve um problema específico (comunicação Claude-Codex) de forma elegante, mas requer setup manual e compreensão profunda da arquitetura MCP.

README

A tradução para o português deste README ainda está na fila.

gaslamp

CI npm npm downloads node license

Minimal MCP server that lets Claude and Codex talk to each other.

Gaslamp wires the two CLIs to each other as plain MCP servers:

directionservertools
Claude → Codexcodex mcp-server registered in Claude as gaslampgaslamp/codex, gaslamp/codex-reply
Codex → Claudethis package, registered in Codex as gaslampgaslamp, gaslamp-reply

claude mcp serve only exposes Claude's tools and a one-shot Agent, not a persistent conversation, so we need a shim in src/server.mjs.

Requirements

Both CLIs installed and logged in: Claude Code and Codex. Node ≥ 18.

Install

npm install -g gaslamp
gaslamp setup           # register both directions
gaslamp doctor          # verify binaries + registrations

Zero-install also works:

npx gaslamp setup

From source

git clone https://github.com/a9lim/gaslamp
cd gaslamp
./setup.sh              # === node bin/gaslamp.mjs setup --local

CLI

gaslamp [serve]        Run the MCP server on stdio (what Codex spawns).
gaslamp setup          Register both directions (add --local for this checkout).
gaslamp doctor         Check binaries + registrations.
gaslamp --version      Print version.
gaslamp --help         Print help.

Permissions

A Codex→Claude consult with no sandbox arg runs with your own Claude config (permission mode, allow/deny rules, model, MCP) — just as your interactive Claude would. Per-call overrides: read-only (advisory, no edits) or danger-full-access (full read/write). Claude has no filesystem sandbox, so there's no workspace-write.

Recursion

A consult is one hop by default: a Claude reached through gaslamp can't turn around and consult Codex, and a Codex reached through gaslamp can't consult Claude back. (The Claude→Codex registration tags the consulted Codex with GASLAMP_NESTED=1, and the spawned Claude is denied the bridge with --disallowedTools mcp__gaslamp.) Only the top-level agent you drive can open a consult. Set GASLAMP_ALLOW_RECURSION=1 to restore unbounded, symmetric handoffs.

Env knobs

vardefaultmeaning
GASLAMP_ALLOWED_TOOLSRead Grep Glob WebFetch WebSearchtools the read-only override permits
GASLAMP_ALLOW_RECURSIONunsetallow a consulted agent to consult back (off = one hop)
GASLAMP_LOGFILE~/.codex/gaslamp.logtranscript path; off to disable
GASLAMP_DEBUGunsetverbose stderr (raw JSON-RPC)
CLAUDE_BINautodetectedpath to the claude binary

Development

npm test                # node --test against a stub claude binary
npm run check           # node -c syntax check on every source file

See CONTRIBUTING.md before opening a PR.

License

AGPL-3.0-or-later. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados