codex-mcps

Workspace of Rust Model Context Protocol (MCP) servers and utilities. Each crate implements a stdin/stdout JSON-RPC service that bridges MCP to another protocol or coordinates Codex agents. They target the Codex toolchain and are only tested there, though they may work with other MCP hosts.

All servers build on the Model Context Protocol Rust SDK for shared MCP transport and data types.

Servers

• mcp-lsp — MCP ↔ Language Server Protocol bridge with tool wrappers for common LSP features.
• mcp-dap — MCP ↔ Debug Adapter Protocol bridge for debugger tooling.
• mcp-lsif — LSIF-backed MCP tools for offline code intelligence queries.
• codex-orchestrator — Agent supervisor that spawns Codex MCP agents and proxies conversation tools.

Shared utilities live in common/ and support Content-Length framed I/O, transport helpers, and test fixtures.

Getting Started

• Prerequisites: Rust 1.75+; optional Node.js for @modelcontextprotocol/inspector.
• Build: cargo build --workspace
• Run a server: cargo run -p mcp-lsp (or mcp-dap, mcp-lsif, codex-orchestrator).
• Test: cargo test --workspace
• Lint/format: cargo fmt and cargo clippy --all-targets --all-features -- -D warnings

Contributing

Follow the workflow, testing, and style guidance in AGENTS.md.

License

MIT — see LICENSE.