AI 编码代理总装错 SDK？SourceWizard 用 MCP 帮你精准安装库依赖
使用 Cursor、Claude Code 这类 AI 编码代理时，你一定遇到过这种情况：让你装个 Clerk 登录组件，它装成了另一个包；让它配一下 Firecrawl，它用了过时的方法；安装 Resend 通知库，结果少了关键的环境变量——代理信誓旦旦说”已安装完成”，跑起来全是报错。
这不是你的问题，也不是 LLM 太笨。核心原因是：软件开发工具包（SDK）的安装流程对 AI 代理来说太模糊了。
人类开发者在 README 中看到的”Quick Start”，对 AI 代理来说是一段需要精确执行的指令脚本。任何歧义——”安装 @yourlib/sdk 或 @yourlib/next-sdk”——对 AI 来说都变成了需要”创造性”（即瞎猜）解决的问题。
SourceWizard 就是为解决这个问题而生的开源 CLI 工具。它通过 MCP（Model Context Protocol）与你的 AI 编码代理集成，提供一个”包安装向导”——当 Claude Code 或 Cursor 需要安装某个库时，SourceWizard 自动查找正确的包名、配置步骤和环境变量，完成完整的安装流程，成功率约 90%。
为什么 AI 代理装库总出错？
SourceWizard 的联合创始人 Ivan Chebykin 在博客中分享了几个关键洞察：
模糊的文档指令对 AI 是毒药。 人类看到”安装 @yourlib/sdk 或 @yourlib/next-sdk”知道该选哪个；AI 代理会在两者之间随机猜测，或者更糟——捏造一个看似合理的安装步骤。
不完整的代码示例导致幻觉。 LLM 非常精确地复制代码示例。如果示例是伪代码或不完整的片段，代理会用自己的知识”补全”——而它补出来的东西很可能在最新版本中已经废弃了。
环境变量被忽略。 人类开发者会在安装后手动配置 .env 文件。AI 代理装完就跑，留下一堆缺少 API Key 的运行错误。
SourceWizard 的解决方案是为每个受支持的包编写”AI 专属安装说明”——精确、完整、去歧义，并集成为 MCP 工具供代理调用。
安装与核心命令
SourceWizard 作为一个 npm 包发布，全局安装即可：
npm install -g sourcewizard
安装后，可以通过几个核心 CLI 命令使用：
sourcewizard search "react testing library" sourcewizard install <包名> sourcewizard mcp sourcewizard status sourcewizard repo [路径]
目前支持的包包括认证服务（Clerk、WorkOS）、搜索 API（Firecrawl）、邮件通知（Resend、Knock）等，项目还在持续扩充中。
与 AI 编码代理集成——这才是核心
SourceWizard 的真正价值不在于终端 CLI 本身，而在于它的 MCP 服务器。通过 MCP 协议，SourceWizard 向 Claude Code、Cursor、Codex 等编码代理暴露两个核心工具：
search_packages：搜索包和代码片段，使用 AI 分析确定正确的包名install_package：安装并配置包，包含完整的安装说明和环境变量设置
集成到 Claude Code 的配置很简单，在 ~/.config/claude-code/mcp_settings.json 中添加：
{
"mcpServers": {
"sourcewizard": {
"command": "npx",
"args": ["sourcewizard", "mcp"],
"env": {
"SOURCEWIZARD_API_KEY": "your-api-key-here"
}
}
}
}
API Key 在 sourcewizard.ai/dashboard 免费获取。配置完成后，当你在 Claude Code 中提问”帮我给项目装 Clerk 登录”，代理会自动调用 SourceWizard 的 MCP 工具，找到正确的包名和执行安装步骤，而不是凭记忆瞎猜。
实际工作流
以 Next.js 项目安装 WorkOS AuthKit 为例：
- AI 代理识别出你需要认证功能
- 代理调用
search_packages确认”WorkOS AuthKit”的确切包名和安装步骤 - 代理调用
install_package，SourceWizard 执行：
- 安装
@workos-inc/authkit-nextjs - 创建
middleware.ts文件（包含完整内容） - 创建回调路由文件
- 配置
.env.local中的环境变量
- 验证安装是否正确完成
整个过程从”让我猜装什么”变成了”查表执行”，成功率大幅提升。
开源与未来发展
SourceWizard 使用 Apache-2.0 许可证开源在 GitHub，目前有 20+ 星标，处于早期但活跃开发阶段。项目的 registry/ 目录按包组织，任何人都可以为新包贡献安装配置——如果你常用的库不在支持列表中，欢迎提交 PR。
总结
SourceWizard 解决的问题很精准：AI 编码代理在安装和配置第三方库时的低成功率。它不试图教 AI 更多知识，而是为每个包编写精确的”AI 级安装说明”，通过 MCP 协议直接暴露给代理调用。
对于日常使用 Claude Code、Cursor 或 Codex 的开发者来说，SourceWizard 像是一个”安装防呆层”——代理装库之前先查一下，就不会装错包、漏配 env、或者用上过时的方法。虽然目前支持的包还不多，但这个方向（为 AI 代理编写结构化安装流程）本身就是对现有 SDK 文档的一次重要修正。
相关链接：