基本能力
产品定位
Fess MCP Server 是一个中间件服务器，用于与 Fess 搜索引擎集成，提供搜索功能。
核心功能
- 与 Fess 搜索引擎集成
- 提供搜索服务接口
- 支持通过 MCP 客户端访问
适用场景
- 需要集成 Fess 搜索引擎的应用
- 需要通过 MCP 客户端访问搜索服务的场景
工具列表
- Fess: 开源的全文搜索服务器
- Docker: 用于容器化部署
- uv: 快速的 Python 包管理器
常见问题解答
- 如何设置 Fess 服务器？请参考官方 Fess 文档。
- 如何配置 Fess MCP Server 的连接？通过环境变量 Fess_API_BASE 设置 Fess 服务器的 URL。
使用教程
使用依赖
- Fess 服务器
- Docker 或 uv（Python 包管理器）
安装教程
使用 Docker
bash
docker-compose up -d
不使用 Docker
```powershell
Install uv
irm https://astral.sh/uv/install.ps1 | iex
Activate virtual environment
..venv\Scripts\activate.bat
Install dependencies
uv pip install -e .
Start MCP server
uv run .\fess_mcp_server.py
```
调试方式
不使用 Docker
```powershell
Install development dependencies:
uv pip install -e ".[test]"
Run unit tests:
uv run pytest -v tests/unit/ -s
Run integration tests (requires communication with Fess server):
uv run pytest -v tests/integration/ -s
Generate coverage report:
uv run pytest --cov=fess_mcp_server --cov-report=html
```
在 Docker 容器中运行测试
```powershell
Build test Docker image:
docker build -t fess-mcp-server-test -f Dockerfile.test .
Run unit tests:
docker run --rm fess-mcp-server-test pytest -v tests/unit/ -s
Run integration tests (requires communication with Fess server):
docker run --rm --network host fess-mcp-server-test pytest -v tests/integration/ -s
Generate coverage report:
docker run --rm -v ${PWD}/coverage:/app/coverage fess-mcp-server-test pytest --cov=fess_mcp_server --cov-report=html
```
