非投机性的
](https://www.npmjs.com/package/@cryptek/non-speculative)  
以文档为中心的MCP服务器，具有语义搜索和可选的RAG答案。 作为MCP STDIO服务器或可选的HTTP服务器运行。CLI优先，npm就绪。
安装
npm i -g @cryptek/non-speculative
# or
npx @cryptek/non-speculative --help快速入门
STDIO（MCP模式）
npx @cryptek/non-speculative --docs-path ./docs
# Use with Claude Code, Cline, or any MCP clientHTTP模式
npx @cryptek/non-speculative --http --port 9000 --docs-path ./docs
# Test HTTP
curl http://localhost:9000/toolsCLI选项
| 标志 | 描述 | 默认值 |
|---|---|---|
| `--docs-path | ||
| ` | 文档目录路径 | $PROJECT_ROOT 或 cwd |
--http | 启用HTTP服务器模式 | false （工作室） |
--port | HTTP服务器端口 | 9000 |
--no-watch | 禁用文件监视 | 默认启用 |
--cache-ttl-ms | 文档索引缓存TTL | 300000 （5分钟） |
--milvus-uri | Milvus服务器类型 | http://localhost:19530 |
--milvus-db | Milvus数据库名称 | default |
--milvus-collection | 收藏名称 | doc_chunks |
--embed-model | 嵌入模型 | nomic-embed-text |
--groq-model | Groq LLM模型 | llama-3.3-70b-versatile |
--no-rerank | 禁用重新登录 | 默认启用 |
--max-concurrency | 最大并发操作数 | 10 |
环境变量
export GROQ_API_KEY="your-groq-api-key" # Required for RAG answers
export MILVUS_URI="http://localhost:19530" # Optional
export MILVUS_TOKEN="your-token" # If using Milvus Cloud
export PROJECT_ROOT="/path/to/docs" # Fallback docs path故障排除
- Milvus不可用：退回到词汇/语义搜索；RAG功能会优雅地降级。
- 文件监视器未触发：在WSL/Docker上，使用
--no-watch并在更改后重新启动。 - Groq API密钥丢失：RAG答案返回搜索结果。
兼容性
- Node.js>=18
路线图
进行中
- 非推测性CLI+OpenTUI板载——交互式初始化向导、依赖性检查、，
.docignore设置，服务器从TUI生成。 - 文档语义成员门——多级门（BM25→ LSH → ANN）与未来分类器。
计划的
- Web UI聊天和规范管理器——与文档聊天，上传/细化规范，管理项目规范。
- DSPy+GEPA集成——通过程序化管道优化检索质量/成本。
- 成本和性能指标——延迟/成本/召回跟踪、仪表板和警报。
- 规范版本控制系统——规范历史、差异、回滚和发布。
贡献
我们欢迎捐款！此存储库启用了分支保护，以保持代码质量：
- 直接推动
main被封锁 -所有更改都必须经过pull请求 - 需要PR审查 -合并前至少需要1个批准
- 状态检查必须通过 -CI测试必须成功
- 对话必须解决 -必须处理所有审查意见
- Claude AI评论 -Claude会自动审查PR的代码质量、安全性和最佳实践
如何做出贡献：
- 分叉此存储库
- 在你的fork中创建一个特征分支(
git checkout -b feature/amazing-feature) - 进行更改并提交(
git commit -m 'Add amazing feature') - 推你的叉子(
git push origin feature/amazing-feature) - 从您的fork向此存储库打开Pull Request
- 等待自动化的Claude AI审查和人工批准
- 处理任何反馈并合并您的PR
对于维护人员
该存储库使用GitHub Actions进行由Claude AI支持的自动公关审查。要启用此功能：
- 添加一个
ANTHROPIC_API_KEY存储库的秘密：
- 转到“设置”→ 秘密和变量→ 行动 - 点击“新建存储库密钥” - 姓名： ANTHROPIC_API_KEY - 价值：您的Anthropic API密钥 - 点击“添加秘密”
- PR审查工作流程(
.github/workflows/pr-review.yml)将自动：
- 触发新的PR和更新 - 分析代码更改 - 发布详细的评论和建议 - 标记安全问题和最佳实践
许可证
麻省理工学院