Fess MCP Server

基本能力

产品定位

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

docker-compose up -d

不使用 Docker

# 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

# 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 容器中运行测试

# 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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。