Solr MCP

一个通过模型上下文协议（MCP）访问 Apache Solr 索引的 Python 包。此集成允许像 Claude 这样的 AI 助手对您的 Solr 索引执行强大的搜索查询，结合了关键字搜索和向量搜索的功能。

特性

• MCP 服务器：实现与 AI 助手集成的模型上下文协议
• 混合搜索：结合关键字搜索的精确度与向量搜索的语义理解
• 向量嵌入：使用 Ollama 和 nomic-embed-text 为文档生成嵌入
• 统一集合：在同一集合中存储文档内容和向量嵌入
• Docker 集成：通过 Docker 和 docker-compose 轻松设置

快速开始

1. 克隆此仓库
2. 使用 Docker 启动 SolrCloud：

   docker-compose up -d
   

3. 安装依赖项：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上: venv\Scripts\activate
   pip install poetry
   poetry install
   

4. 处理并索引示例文档：

   python scripts/process_markdown.py data/bitcoin-whitepaper.md --output data/processed/bitcoin_sections.json
   python scripts/create_unified_collection.py unified
   python scripts/unified_index.py data/processed/bitcoin_sections.json --collection unified
   

5. 运行 MCP 服务器：

   poetry run python -m solr_mcp.server
   

有关更详细的设置和使用说明，请参阅 QUICKSTART.md 指南。

要求

• Python 3.10 或更高版本
• Docker 和 Docker Compose
• SolrCloud 9.x
• Ollama（用于生成嵌入）

许可证

本项目根据 MIT 许可证发布 - 详情请参见 LICENSE 文件。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 获取指南。