雨淋mcp
一个严格的、对初学者友好的MCP服务器,用于支持Deluge语法。
特性
- 严格的来源管理(
www.zoho.com/deluge/help/**仅) - 损坏/嘈杂的代码段拒绝
- 工具用于:
- deluge_health - deluge_explain - deluge_validate - deluge_fix - deluge_examples - zoho_crm_js_examples
- MCP资源:
- deluge://rules/v1 - deluge://cheatsheet/beginner - deluge://topics/v1 - deluge://snippets/v1 - deluge://canonical-index/v1 - deluge://coverage/v1 - zoho://crm-js-sdk/snippets/v1 - zoho://crm-js-sdk/topics/v1 - zoho://crm-js-sdk/canonical-index/v1 - zoho://crm-js-sdk/coverage/v1
这篇PR有什么新内容
- 为Deluge和Zoho CRM JavaScript SDK策划知识包管道。
- 规范代码段模型,包括:
- canonicalKey, apiFamily, operation, version, stability - requiresScopes, requiresModule - sampleVsReference, confidence, tier - 合并 variants 以及规范索引组
- 工具中的新检索控件:
- canonical_key - tier (A|B|C) - include_variants
- 用于治理和可观察性的新MCP资源:
- deluge://canonical-index/v1 - deluge://coverage/v1 - zoho://crm-js-sdk/canonical-index/v1 - zoho://crm-js-sdk/coverage/v1
deluge_health现在报告管理元数据(模式版本、覆盖完成、缺少密钥、层计数、变量统计)。- 漂移控制自动化:
- Deluge和Zoho的每周更新工作流程 - diff报告 data/reports/ - A级规范变更的手动审查门
- 为这两个知识包增加了管理/检索测试覆盖率和基于场景的烟雾检查。
设置
npm install安装git挂钩(通常通过自动运行 prepare 安装时):
npm run prepare项目治理
存储库策略和贡献文档:
CONTRIBUTING.mdCONTRIBUTORS.mdSECURITY.md
GitHub元数据文件:
.github/CODEOWNERS.github/pull_request_template.md.github/ISSUE_TEMPLATE/*.github/dependabot.yml.github/labels.json
代码质量自动化
此仓库使用Biome+lint staged+Husky:
- 预提交钩子在stage上运行
*.ts|*.tsx|*.js|*.mjs|*.cjs - 每个暂存文件都通过以下方式进行过梁和自动格式化
biome check --write
手动命令:
npm run lint
npm run lint:fix
npm run format稳定完整套件的单一命令:
npm run verify全套服务,包括stdio检查:
npm run verify:full从repo配置同步GitHub标签:
npm run labels:sync发布
此仓库包含一个带有标志的发布助手:
npm run release -- --help常见的释放命令:
npm run release:patch
npm run release:minor
npm run release:major
npm run release:alpha
npm run release:beta
npm run release:rc基于标志的示例:
npm run release -- --type prerelease --preid beta
npm run release -- --type minor --no-push
npm run release -- --type patch --skip-verify
npm run release -- --type patch --dry-run支持的标志:
- `--type
`
--preid(与--type prerelease)--skip-verify(跳过npm run verify)--no-push(仅在本地创建版本提交/标记)--allow-dirty(允许在肮脏的工作树上释放)--remote(默认值origin)--dry-run(仅打印计划命令)
笔记:
- 释放流量运行
npm version ...(创建commit+标签),然后推送分支和标签。 - 此包裹已标记
"private": true,因此此流程管理git版本/标签,而不是npm发布。
摄入上下文数据
将Context7导出放在 data/raw/context7.md 并运行:
npm run ingest -- data/raw/context7.md输出被写入 data/processed/snippets.json.
构建/刷新精心策划的Deluge知识库元数据(规范索引、层次、覆盖率):
npm run kb:deluge一键助手:
npm run ingest:oneclick -- data/raw/context7.md data/processed/snippets.json摄入后,重新涂抹Deluge护理:
npm run kb:deluge洪水知识管理
架构: deluge-kb/v1
精心策划的《大洪水》片段包括:
canonicalKey(api_family.operation)apiFamily,operationversion,stabilityrequiresScopes,requiresModulesampleVsReferenceconfidence和tier(A|B|C)variants(合并候补)
层级政策:
A:高置信度生产安全参考B:标准示例和使用模式C:风险/错误路径或置信度较低的参考
命令:
npm run kb:deluge
npm run kb:deluge:refresh
npm run kb:deluge:refresh:allow-tier-a
npm run kb:deluge:diffZoho CRM JS SDK知识包(Context7)
该仓库包括一个针对Context7库的精心策划的知识包:
- 库ID:
/zoho/zohocrm-javascript-sdk-8.0 - 原始种子文件:
data/raw/zoho-crm-js-sdk-context7.md - 处理输出:
data/processed/zoho-crm-js-sdk-snippets.json - Diff报告:
- data/reports/zoho-crm-js-sdk-diff-report.json - data/reports/zoho-crm-js-sdk-diff-report.md
治疗模式
架构: zoho-crm-js-sdk-kb/v1
每个规范片段包括:
canonicalKey(api_family.operation)apiFamily,operationversion,stabilityrequiresScopes,requiresModulesampleVsReferenceconfidence和tier(A|B|C)variants(合并候补)
层级政策:
A:安全生产参考模式B:示例/演示用法C:结构参考碎片(APIDOC重)
构建包:
npm run kb:zoho-crm-js-sdk刷新+差异+手动审核门:
npm run kb:zoho-crm-js-sdk:refresh人工审核后允许A级促销:
npm run kb:zoho-crm-js-sdk:refresh:allow-tier-a仅运行diff:
npm run kb:zoho-crm-js-sdk:diff运行服务器
npm run dev或
npm run build && npm start冒烟测试
主烟雾(内存中的MCP客户端/服务器):
npm run smoke可选标准烟雾(取决于环境):
npm run smoke:stdio矩阵烟雾(可扩展的基于场景的检查):
npm run smoke:matrix检索质量场景:
npm run smoke:retrievalZoho检索质量场景:
npm run smoke:zoho-retrievalstdio上方的矩阵烟雾:
npm run smoke:matrix:stdio深度stdio诊断(确定失败步骤):
npm run diagnose:stdio根据特定cwd/timeout进行诊断:
npm run diagnose:stdio -- --cwd /absolute/path/to/project --timeout 180000诊断以npm开头的MCP配置:
npm run diagnose:stdio -- --command npm --args-json '["run","dev"]' --cwd /absolute/path/to/project运行自定义场景文件:
npm run build
node scripts/smoke-matrix.mjs --scenario scripts/scenarios/default-smoke.json本地测试快捷方式(运行stdio冒烟):
npm run test:local运行核心烟雾和矩阵烟雾:
npm run test:mcpMCP客户端配置示例(stdio)
{
"mcpServers": {
"deluge": {
"command": "node",
"args": ["/absolute/path/to/deluge-mcp/dist/src/index.js"]
}
}
}故障排除
如果你看到 ENOENT 或 Could not read package.json,您的MCP客户端在错误的工作目录中运行该命令。
- 如果使用
npm run dev,设置MCP服务器cwd到这个repo根目录。 - 对于便携式设置,首选直接节点命令:
{
"mcpServers": {
"deluge": {
"command": "node",
"args": ["/absolute/path/to/deluge-mcp/dist/src/index.js"]
}
}
}