cclsp
连接AI编程助手与LSP语言服务器的桥梁,解决定位不准问题。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:cclsp。 它的用途是:连接AI编程助手与LSP语言服务器的桥梁,解决定位不准问题。 完整的 Skill 内容见:https://321skill.com/skills/cclsp/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查找一下这个 `calculateTotal` 函数在哪里定义的,以及它被哪些地方调用了。” AI通过cclsp可以精准定位到函数定义的文件和行号,并列出所有引用该函数的位置,即使AI最初给出的位置有偏差。或者,当你想重命名一个变量时,可以说:“把这个 `userName` 变量重命名为 `username`。” AI会通过cclsp安全地完成整个代码库中的符号重命名。
介绍
cclsp 是一个 Model Context Protocol (MCP) 服务器,旨在解决LLM编程助手(如Claude)与语言服务器(LSP)集成时的核心痛点。AI助手在提供代码行号、列号时经常不准确,导致直接调用LSP功能(如跳转定义、查找引用)失败或结果混乱。cclsp 通过智能尝试多种位置组合并提供鲁棒的符号解析,让AI助手能可靠地使用LSP功能,无论AI如何计数行号。
使用 cclsp 非常简单。它提供了交互式设置向导,只需运行 npx cclsp@latest setup 即可完成配置。它会引导你配置Claude Desktop等AI助手,并安装所需的语言服务器(如TypeScript、Python、Go等)。配置完成后,你的AI助手就能通过MCP调用cclsp提供的工具,实现精准的代码导航。
这个工具非常适合依赖AI助手进行代码理解、重构和导航的开发者,特别是前端开发、后端开发和全栈开发人员。当你在与AI讨论复杂代码库,需要快速查找函数定义、查看所有引用或安全地重命名符号时,cclsp 能极大提升效率。
建议在使用前确保已安装Node.js 18+或Bun环境,并根据项目语言预先安装好对应的语言服务器(如 typescript-language-server, python-lsp-server)。cclsp 的自动化配置是其亮点,能帮你省去繁琐的手动MCP配置步骤。
核心特点
核心区别在于它专门解决了AI助手输出位置信息不准确导致LSP调用失败的问题,通过智能位置重试机制,让AI能可靠地使用“跳转定义”、“查找引用”等高级代码导航功能,而同类工具通常假设位置信息是准确的。
注意事项
需要预先在系统中安装并配置好对应编程语言的独立语言服务器(LSP server)。
常见问题
cclsp 支持哪些编程语言?
支持任何有LSP服务器的语言,内置了对TypeScript、Python、Go等的配置示例,可通过配置文件扩展。
必须使用 Claude 吗?
不,cclsp 是一个MCP服务器,理论上任何支持MCP客户端协议的AI助手(如Cursor)都可以配置使用。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/cclsp/raw/index.md 读取 cclsp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/cclsp/raw/index.md(查看排版版本)