Fess MCP Server

Fess MCP 服务

Fess MCP 服务是一个与 Fess 搜索引擎集成的中间件服务。 在 Claude for Desktop 等 MCP 客户端的设置中注册后，Agent 便可使用 Fess 获取信息。Fess 是基于 Apache License 提供的开源全文搜索服务。也提供商业支持。更多详情请参阅官方网站。 https://fess.codelibs.org/ja/

设置

Fess 设置

有关 Fess 服务本身的设置步骤，请参阅 Fess 官方文档。 https://qiita.com/g_fukurowl/items/a00dbbad737d3e775108

以下文章也可能有所帮助： https://qiita.com/g_fukurowl/items/a00dbbad737d3e775108

Fess MCP 服务设置

使用 Docker

使用以下命令启动服务：

docker-compose up -d

不使用 Docker

这里介绍使用 uv 的设置步骤。 uv 是一款快速的 Python 包管理器。虽然不是必需的，但我们建议使用它。

# 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

配置

Fess 服务连接设置

Fess MCP 服务访问的 Fess 服务 URL 通过环境变量 Fess_API_BASE 设置。 启动 Fess MCP 服务之前，请根据你的环境修改此变量。 如果以 Docker 容器运行，请编辑 docker-compose.yaml 并更改相关设置。

Claude for Desktop 连接设置

Fess MCP 服务默认在端口 8000 上启动。 如果 Fess MCP 服务正在 localhost 的端口 8000 上运行，请按如下方式编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "fess-search-sse": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:8000/sse"
        ]
      }
  }
}

测试

不使用 Docker

这里介绍使用 uv 的测试步骤。

# 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

测试执行选项

• -v：显示详细输出
• -s：显示标准输出
• --cov：生成覆盖率报告
• --cov-report=html：生成 HTML 覆盖率报告

许可证

MIT License