AGENTS.md

1# lsp-tools-mcp -- LSP Tools stdio MCP (MCP layer)
2 
3**Generated:** 2026-07-17 / 7d664b96b
4 
5## OVERVIEW
6 
7Vendored, Node-targeted MCP-layer package (`@code-yeongyu/lsp-tools-mcp`). Serves LSP tools via stdio MCP, consuming [`lsp-core`](../lsp-core/AGENTS.md) for tool definitions + LSP runtime and [`mcp-stdio-core`](../mcp-stdio-core) for JSON-RPC framing. Registered as tier-1 MCP `lsp` in [`packages/omo-opencode/src/mcp/`](../omo-opencode/src/mcp/AGENTS.md). Used directly by the OpenCode edition and consumed by [`lsp-daemon`](../lsp-daemon/AGENTS.md) for the Codex edition.
8 
9## TOOLS SERVED
10 
11- `lsp_diagnostics`
12- `lsp_goto_definition`
13- `lsp_find_references`
14- `lsp_symbols`
15- `lsp_prepare_rename`
16- `lsp_rename`
17- `lsp_status`
18- `lsp_install_decision`
19 
20## KEY FILES
21 
22| File | Role |
23|------|------|
24| `cli.ts` | Bin `omo-lsp`. `mcp` subcommand → `runMcpStdioServer()` |
25| `mcp.ts` | Re-exports `@oh-my-opencode/lsp-core/mcp` (stdio MCP server + JSON-RPC handler) |
26| `tools.ts` | Re-exports `@oh-my-opencode/lsp-core/tools` (tool definitions + runtime dispatch) |
27| `request-context.ts` | Re-exports `@oh-my-opencode/lsp-core/request-context` |
28| `lsp/manager.ts` | Re-exports `@oh-my-opencode/lsp-core/lsp/manager` |
29 
30## NOTES
31 
32- **Node + npm + vitest + biome, NOT Bun.** Built with `npm ci` + `npm run build` (triggered from root via `bun run build:lsp-tools-mcp`). `engines.node >= 20`.
33- **All logic lives in `lsp-core`.** This package is a thin vendored shim that re-exports the core and adds a standalone CLI entry.
34- **Config:** `.codex/lsp-client.json` (project) and `~/.codex/lsp-client.json` (user), overridable via `LSP_TOOLS_MCP_PROJECT_CONFIG` and `LSP_TOOLS_MCP_USER_CONFIG`.
35