SuperAPI AI 工具集

lsp-setup

编程与开发

查看项目

更新于 11-15 16:06

技能介绍

用途

lsp-setup 用于为当前代码仓库配置 LSP(Language Server Protocol)代码智能,使 AI 编程助手在会话开始后即可通过语言服务器精准定位符号、跳转定义、查找引用和获取诊断信息。其配置按全局与项目两级分离,尽量不影响其他项目。

主要能力

  • 检查并补齐 Claude Code LSP 插件:设置 ENABLE_LSP_TOOL 环境变量、注册 Piebald-AI/claude-code-lsps marketplace,并按项目语言启用对应插件。
  • 按项目标志文件安装语言服务器:tsconfig.json/package.json 对应 vtsls(npm i -g @vtsls/language-server);go.mod 对应 gopls(go install golang.org/x/tools/gopls@latest);pyproject.toml/requirements.txt 对应 pyright(pip3 install pyright);Cargo.toml 对应 rust-analyzer(rustup component add rust-analyzer)。
  • 配置 Codex LSP MCP:检查并构建 ~/.codex/tools/lsp-mcp/target/release/lsp-mcp,写入 ~/.codex/config.toml 全局 MCP 注册,生成项目级 .lsp-mcp.json,并在 .git/info/exclude 中加入本地忽略项。
  • 按锁文件安装项目依赖:pnpm-lock.yaml 用 pnpm install --frozen-lockfile,package-lock.json 用 npm ci,go.mod 用 go mod download。
  • 向项目 CLAUDE.md 和 .codex/AGENTS.md 追加“代码检索”规则;若 CLAUDE.md 已被 Git 跟踪,则不自动修改,避免本地说明进入团队 PR。
  • 安装 LSP 会话 hook:把 lsp-session.sh 复制到项目 .claude/hooks/,并在 .claude/settings.local.json 中注册 SessionStart hook(matcher 为 startup|resume|clear|compact,command 使用相对路径 bash .claude/hooks/lsp-session.sh)。
  • 本地忽略:确认 .git/info/exclude 包含 .claude/hooks/、.claude/settings.local.json、.lsp-mcp/、.lsp-mcp.json。

使用方式

第一步运行诊断脚本:

bash ~/.claude/skills/lsp-setup/scripts/lsp-doctor.sh --project-dir "$(pwd)"

若输出含 [MISSING],加 --fix 自动修复:

bash ~/.claude/skills/lsp-setup/scripts/lsp-doctor.sh --fix --project-dir "$(pwd)"

只安装 Codex LSP MCP 时使用窄模式:

CODEX_HOME="${CODEX_HOME:-$HOME/.codex}" bash ~/.claude/skills/lsp-setup/scripts/lsp-doctor.sh --fix --codex-lsp-only --project-dir "$(pwd)"

第二步安装会话 hook:

mkdir -p .claude/hooks cp ~/.claude/skills/lsp-setup/hooks/lsp-session.sh .claude/hooks/lsp-session.sh chmod +x .claude/hooks/lsp-session.sh

然后在项目 .claude/settings.local.json 中添加 SessionStart hook 配置(结构见上方资料)。

适用场景

适用于需要在 Claude Code 或 Codex 中为具体代码仓库启用 LSP 代码智能的开发者,尤其是多语言项目、希望项目级配置不污染全局配置、希望 AI 助手通过语言服务器检索符号而非纯文本搜索的场景。

限制与注意事项

  • 各项配置的写入位置有明确划分:LSP 二进制、Claude Code 插件注册、Codex lsp-mcp 二进制与 MCP 注册为全局,其余为项目级。
  • Codex 版检索规则只写当前可用工具集:documentSymbol、goToDefinition、findReferences、hover、getDiagnostics。
  • 脚本对 lsp-mcp 应用了兼容补丁,修复 stale diagnostics 过滤、documentSymbol 不取 snippet、嵌套符号不逐个 hover、多字节字符 panic。
  • 常见问题:gopls 缓存过期可执行 pkill -f gopls 后重开会话;LSP 首次冷启动较慢,可等 3-5 秒再重试;node_modules 过期可删除后重跑 --fix;Codex 新会话未暴露 LSP MCP 时,确认 ~/.codex/config.toml 含 [mcp_servers.lsp-mcp] 并完全新开 Codex 窗口。
  • 资料未提供该技能的具体版本号、许可协议与作者支持渠道,暂未提供。