Fess MCP Server

🚀 Fess MCP サーバ

Fess MCP サーバは、Fess 検索エンジンと統合されたミドルウェアサーバです。MCP クライアント（例：Desktop Claude）の設定でこのサーバを登録することで、Fess を使った情報取得を代理で行うことができます。Fess はオープンソースの全文検索サーバで、Apache ライセンスの下で提供されています。商用サポートも利用可能です。詳細については、公式ウェブサイトをご覧ください。 https://fess.codelibs.org/ja/

🚀 クイックスタート

Fess MCP サーバを使うことで、MCP クライアントから Fess を通じて情報を取得できます。以下に、サーバのインストール、設定、テストの手順を説明します。

✨ 主な機能

• Fess 検索エンジンとの統合
• MCP クライアント（Desktop Claude など）からの情報取得の代理

📦 インストール

Fess インストール

Fess サーバ自体のインストール手順については、公式 Fess ドキュメントを参照してください。 https://qiita.com/g_fukurowl/items/a00dbbad737d3e775108

以下の記事も参考になるかもしれません。 https://qiita.com/g_fukurowl/items/a00dbbad737d3e775108

Fess MCP Server インストール

Docker を使用する場合

以下のコマンドを使ってサーバを起動します。

docker-compose up -d

Docker を使用しない場合

ここでは、uv（高速な Python パッケージマネージャ）を使ったインストール手順を示します。uv は必須ではありませんが、推奨されます。

# 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 Server がアクセスする Fess サーバの URL は、環境変数 Fess_API_BASE として設定されます。 Fess MCP Server を起動する前に、環境に合わせてこの変数を変更してください。Docker コンテナで実行する場合は、docker-compose.yaml を編集して関連設定を変更してください。

Desktop Claude 接続設定

Fess MCP Server はデフォルトで 8000 ポートで動作します。 Fess MCP Server が localhost の 8000 ポートで動作している場合、claude_desktop_config.json を以下のように編集してください。

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

💻 使用例

基本的な使用法

Fess MCP サーバをインストールし、設定を完了したら、MCP クライアントから Fess を通じて情報を取得できます。具体的な手順は、上記のインストールと設定のセクションを参照してください。

📚 ドキュメント

テスト

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 License