Fess MCP Server

Fess MCP服务器

Fess MCP Server是一个与Fess搜索引擎集成的中间件服务器。 通过在MCP客户端（如Claude for Desktop）的设置中注册它，它使代理能够使用Fess获取信息。Fess是一个根据Apache许可证提供的开源全文搜索服务器。商业支持也是可用的。如需了解更多详情，请访问官方网站。 https://fess.codelibs.org/ja/

设置

粪便设置

有关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用于桌面连接设置

默认情况下，Fess MCP服务器在端口8000上启动。 如果Fess MCP服务器在端口8000的本地主机上运行，请按如下方式编辑claude_desktop_config.json：

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

测试

没有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

测试执行选项

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

许可证

MIT许可证