SuperAPI AI 工具集

lsp-setup

智能体与模型

查看项目

更新于 10-15 20:13

技能介绍

LSP Setup 用于为项目配置合适的语言服务器,让 lsp MCP 工具真正可用,包括诊断(diagnostics)、跳转定义(goto_definition)、查找引用(find_references)、符号(symbols)和重命名(rename)。它本身是一个索引式技能:先探测项目需要什么,再安装服务器、写配置,最后用一次真实往返验证。

用途与语言门禁:先按文件扩展名判断语言,再阅读对应参考文件,之后才安装或配置。覆盖语言包括 TypeScript/JS(.ts .tsx .js .jsx .mjs .cjs .mts .cts .vue .svelte .astro)、Python(.py .pyi)、Go(.go)、Rust(.rs)、C/C++(.c .cpp .cc .cxx .h .hpp .hh .hxx)、Java(.java)、Kotlin(.kt .kts)、C#(.cs .razor .cshtml)、Swift(.swift)、Ruby(.rb .rake .gemspec .ru)、PHP(.php)、Dart(.dart)、Elixir(.ex .exs)、Zig(.zig .zon)、Lua(.lua)、Bash(.sh .bash .zsh .ksh)、YAML(.yaml .yml)、Terraform(.tf .tfvars)、Haskell(.hs .lhs)、Julia(.jl)。

工作流为检测→安装→配置→验证。检测:bun scripts/detect-lsp.ts <projectDir>,可加 --json;会输出内置服务器 id、所需可执行文件、是否已安装、安装提示以及项目配置是否已引用。安装:按参考文件运行对应操作系统命令,并用 command -v <server-executable> 确认可执行文件可解析,例如 typescript-language-server、gopls、rust-analyzer。配置:多数内置服务器无需配置,会按扩展名自动解析;仅在需要选择服务器、设置优先级、传入初始化选项、覆盖扩展名、设置环境变量或禁用服务器时才写配置。项目级配置文件为 .codex/lsp-client.json(Codex)和 .opencode/lsp.json(OpenCode/omo,也支持 .omo/lsp.json)。项目配置中内置 id 自动继承 command,只可覆盖 extensions/priority/initialization;非内置 id 在项目配置中被忽略,完全自定义服务器需写入用户配置(~/.codex/lsp-client.json 或 LSP_TOOLS_MCP_USER_CONFIG 指定路径)。项目条目优先于用户条目,两者都优先于内置默认。验证:bun scripts/verify-lsp.ts <path/to/file.ext>,可加 --timeout=90000;OK 表示服务器启动并响应,FAIL 中“language server not installed”需回到安装步骤,其他 FAIL 携带服务器或启动错误,SKIP 表示引擎源码未找到,需在 omo 仓库/工作树内运行或直接调用 lsp MCP 诊断工具。脚本还有 scripts/lsp-server-table.ts 提供各语言主要内置服务器快照。运行需 Bun:curl -fsSL https://bun.sh/install | bash 。内置服务器清单以 packages/lsp-tools-mcp/src/lsp/server-definitions.ts 中的 BUILTIN_SERVERS 与 LSP_INSTALL_HINTS 为准。资料未提供收费、价格或效果说明。