Fess MCP 服务器

Fess MCP 服务器是一个与 Fess 搜索引擎集成的中间件服务器。 通过在 Claude for Desktop 等 MCP 客户端的设置中注册它，可以使代理能够使用 Fess 获取信息。 Fess 是一个根据 Apache 许可证提供的开源全文搜索服务器。 也提供商业支持。 有关更多详细信息，请参阅官方网站。 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 包管理器。 虽然不是必需的，但我们建议使用它。

# 安装 uv
irm https://astral.sh/uv/install.ps1 | iex

# 激活虚拟环境
.\.venv\Scripts\activate.bat

# 安装依赖
uv pip install -e .

# 启动 MCP 服务器
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 的测试步骤。

# 安装开发依赖:
uv pip install -e ".[test]"

# 运行单元测试:
uv run pytest -v tests/unit/ -s

# 运行集成测试 (需要与 Fess 服务器通信):
uv run pytest -v tests/integration/ -s

# 生成覆盖率报告:
uv run pytest --cov=fess_mcp_server --cov-report=html

在 Docker 容器中运行测试

# 构建测试 Docker 镜像:
docker build -t fess-mcp-server-test -f Dockerfile.test .

# 运行单元测试:
docker run --rm fess-mcp-server-test pytest -v tests/unit/ -s

# 运行集成测试 (需要与 Fess 服务器通信):
docker run --rm --network host fess-mcp-server-test pytest -v tests/integration/ -s

# 生成覆盖率报告:
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 许可证