@happyvertical/sdk-mcp (英语)
Have SDK的MCP服务器将开发者的查询传送到包文件. 它扫描每个包 AGENT.md 文件在启动时创建关键词索引登记册,并披露三种MCP工具: ask (AI动力QQA), list-packages,以及 get-docs。 。 。 .
安装
pnpm install @happyvertical/sdk-mcp
释放到 npm.happyvertical.com 并镜像到公共 npm , 它可以滞后; 见 root README 的安装注释
@happyvertical:registry线条。 公共 npm 不需要范围化的注册配置 .
使用量
作为 MCP 服务器
该包提供了基于stdio的MCP服务器. 直接运行 :
npx sdk-mcp
或者在您的 MCP 客户端( 如 Claude Desktop) 中配置它以启动为子进程 .
Claude 代码背景 CLI
将 AGENT.md 和元数据复制到您的项目中 .claude/ aI辅助开发目录:
npx have-sdk-mcp-context
环境变量
这个 ask 工具需要一个 AI 提供者。 设定其中之一 :
HAVE_AI_API_KEY——任何提供者的倒置 API 密钥HAVE_AI_TYPE- 提供者类型(openai, (中文(简体) ),anthropic, (中文(简体) ),gemini(中文(简体) )OPENAI_API_KEY, (中文(简体) ),ANTHROPIC_API_KEY,或GEMINI_API_KEY
这个 list-packages 财务报告和审定财务报表 get-docs 工具工作时没有AI配置.
MCP 工具
询问
问个关于SDK的问题 通过关键词匹配与相关包的路由,并使用AI(top 3匹配)合成一个响应.
{
"query": "How do I send an email with an attachment?",
"packages": ["email", "messages"]
}
query(需要)——问的问题packages(可选) – 明确包名可参考而非自动路由
列表包
列出所有已发现的带有描述和关键词的SDK包. 无参数 .
获取文件
获取特定软件包的全部 AGENT.md 内容 .
{
"packageName": "ai"
}
如何运作
-
书记官处 -一接到电话就扫描
packages/*/AGENT.md并建立一个Map<string, PackageMetadata>键入软件包名称。 每个条目包括描述(取自AGENT.md),关键词(取自registry.ts),和完整的文档内容. -
路线 ——将用户查询分解为令牌并按关键词重合给每个包打分(准确匹配=10平分,部分=5平分,名称奖金=15平分). 低于最低分数门槛的套件不包括在内.
-
综述 - 电话
ask工具装入 AGENT.md 用于前3个匹配的软件包,根据上下文构建一个系统提示,并调用@happyvertical/ai生成一个响应.
添加新软件包
- 创建一个
AGENT.md在新软件包目录中 - 添加关键字条目
src/registry.ts(单位:千美元)PACKAGE_KEYWORDS(中文(简体) ) - 重建:
pnpm run build
软件包将在下一个服务器启动时自动被发现.
API 密码
书记官处registry.ts(中文(简体) )
| 导出 | 说明 |
|---|---|
PackageMetadata | 接口 : name, (中文(简体) ), path, (中文(简体) ), description, (中文(简体) ), claudeMd, (中文(简体) ), keywords |
PACKAGE_KEYWORDS | 用于路由的静态关键字到包装映射 |
buildPackageRegistry() | 扫描软件包目录并返回缓存 Map<string, PackageMetadata> |
getPackage(name) | 获取单个软件包的元数据 |
getAllPackages() | 将所有软件包元数据作为数组 |
getPackageDocs(name) | 获取软件包的原始 AGENT.md 内容 |
clearCache() | 清除内存登记缓存 |
路由器( R)router.ts(中文(简体) )
| 导出 | 说明 |
|---|---|
PackageMatch | 接口 : package, (中文(简体) ), score, (中文(简体) ), matchedKeywords |
routeQuery(query, minScore?) | 针对查询字符串的分数和排序软件包 |
getPackagesByNames(names) | 以明确名称列表查看软件包 |
getTopPackages(query, limit?) | 简指 routeQuery + 切片 |
工具( E)tools/(中文(简体) )
| 导出 | 说明 |
|---|---|
ask(input) | AI 驱动的 XQA 工具 |
listPackages() | 列出所有软件包 |
getDocs(packageName) | 获取软件包文档 |
依赖关系
@happyvertical/ai- 提供ask工具@modelcontextprotocol/sdk- MCP协议的执行
发展
pnpm run build # Build
pnpm test # Run tests
pnpm run dev # Watch mode (build + test)
许可证
麻省理工学院