MCP server exposing read-only LSP navigation tools for Codex
Project description
codex-lsp-mcp
codex-lsp-mcp is a local MCP stdio server that exposes read-only LSP navigation tools to Codex.
Built-in defaults target clangd; additional LSP backends can be configured in
~/.config/codex-lsp-mcp/config.toml.
Quick start
Run the published package from PyPI:
uvx codex-lsp-mcp
Local development
uv run pytest
uvx --from . codex-lsp-mcp
Codex configuration
codex mcp add codex-lsp-mcp -- uvx codex-lsp-mcp
Check registration:
codex mcp get codex-lsp-mcp
If clangd is not on Codex's PATH, set:
[mcp_servers.codex-lsp-mcp.env]
CLANGD_BIN = "/path/to/clangd"
The server discovers the closest compile_commands.json from the queried file path.
Tool coordinates follow the LSP convention: zero-based line and character.
When multiple configured LSP backends match the same workspace directory, pass
server_name to workspace_symbols to select the intended backend explicitly.
Release history Release notifications | RSS feed
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 codex_lsp_mcp-0.2.0.tar.gz.
File metadata
- Download URL: codex_lsp_mcp-0.2.0.tar.gz
- Upload date:
- Size: 16.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fa8112b71f28fa206e279333f5241da73bcf92bb5439d38835e65e4bc7e7c6b
|
|
| MD5 |
291858a329b13e73dcb8f6f511feaae9
|
|
| BLAKE2b-256 |
56ad7c38556aa812ff139f4b94d86ef19cf6aa76c6ff87aa9708589afe7720e0
|
File details
Details for the file codex_lsp_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: codex_lsp_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 12.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f59e8b7618cf3a7517f0312dfb0f4092a467ea5232c7c8ccd24a9a512bb0b69
|
|
| MD5 |
98a3fc3345abc2f5504b95c7697c7509
|
|
| BLAKE2b-256 |
af4c77bccf6875acd1a55c4fdcb4f8ad63f1e9067bf3cc8cc96393277f72a1af
|
