Lucene MCPサーバー

「Lucene」MCPサーバーは何をするものですか？

MCP Luceneサーバーは、Apache Luceneを利用したModel Context Protocol（MCP）のJava実装であり、効率的な検索・取得機能を提供します。MCP準拠サーバーとして、大規模なドキュメントリポジトリに対し、全文検索・インデックス作成・メタデータフィルタリングなどのタスクをAIアシスタントやエージェントが実行できるようにします。RESTful API経由で、Luceneの強力なクエリ構文を利用したドキュメントのアップサート（追加/更新）、削除、一覧取得、検索が可能です。Spring Bootベースで構築されているためデプロイも容易で、Dockerによるコンテナ化も対応しています。AI駆動ワークフローやソフトウェア開発パイプラインへの高度なドキュメント検索・管理機能の統合に最適なサーバーです。

プロンプト一覧

リポジトリにはプロンプトテンプレートに関する情報はありません。

リソース一覧

リポジトリに明示的なMCPリソース記載はありません。

ツール一覧

• アップサートツール

  • /mcp/v1/upsert エンドポイント経由でLuceneインデックスへのドキュメント追加・更新が可能。

• 削除ツール

  • /mcp/v1/delete エンドポイントでLuceneインデックスからドキュメント削除を実行。

• 一覧ツール

  • /mcp/v1/list エンドポイント経由でインデックスからドキュメントの一覧を取得。

• クエリツール

  • /mcp/v1/query エンドポイントでLuceneクエリ構文を用いた高度な検索が可能。

• ステータスツール

  • /mcp/v1/status エンドポイントでサーバーステータスを確認。

このMCPサーバーのユースケース

• エンタープライズドキュメント検索
  Lucene MCPサーバーを統合することで、大量の業務ドキュメントに対して堅牢かつスケーラブルな検索機能を提供し、関連ファイルや記録の容易な検索を実現します。

• ナレッジベース拡張
  会社のマニュアルやFAQ、サポートチケットなどをインデックス化し、AIアシスタントが検索・取得できるように強化します。

• 自動データ取り込み・インデックス作成
  ドキュメントの追加・更新をプログラムから自動で行い、検索エンジンを常に最新の状態に保つことが可能です。

• メタデータによるフィルタリング
  Luceneの機能を活かし、ドキュメントのメタデータをもとにした高度な検索・データ取得が可能です。

• API駆動型検索統合
  他アプリケーションやエージェントがRESTfulエンドポイント経由でドキュメント検索・管理機能をシームレスに利用できます。

セットアップ方法

Windsurf

1. Java 11以上およびMaven 3.6以上がインストールされていることを確認します。
2. プロジェクトをビルド:

   mvn clean install
   

3. MCP Luceneサーバーを構成に追加:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 設定を保存し、Windsurfを起動します。
5. http://localhost:8080/mcp/v1/status でサーバーの稼働を確認します。

Claude

1. Java 11以上およびMaven 3.6以上をインストールします。
2. プロジェクトをビルド:

   mvn clean install
   

3. Claudeの設定ファイルに以下を追加:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Claudeを再起動し、MCP Luceneサーバーに接続できることを確認します。

Cursor

1. Java 11以上およびMaven 3.6以上がインストールされていることを確認します。
2. Lucene MCPサーバーをビルド:

   mvn clean install
   

3. Cursorの設定に追加:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 設定を保存しCursorを再起動します。
5. http://localhost:8080/mcp/v1/status でエンドポイントをテストします。

Cline

1. Java 11以上およびMaven 3.6以上がインストールされていることを確認します。
2. ビルド:

   mvn clean install
   

3. Clineの設定に以下を記述:

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. Clineを再起動し、MCPサーバーが稼働していることを確認します。

APIキーのセキュリティに関する注意

APIキーや機密情報のセキュリティが必要な場合は、環境変数を利用してください:

{
  "mcpServers": {
    "lucene-mcp": {
      "command": "java",
      "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"],
      "env": {
        "LUCENE_API_KEY": "${LUCENE_API_KEY}"
      },
      "inputs": {
        "apiKey": "${LUCENE_API_KEY}"
      }
    }
  }
}

フロー内でこのMCPを使う方法

FlowHuntでのMCP利用

FlowHuntのワークフローにMCPサーバーを統合するには、まずフローにMCPコンポーネントを追加し、AIエージェントと接続します。

MCPコンポーネントをクリックして設定パネルを開き、システムMCP設定セクションに以下のJSONフォーマットでMCPサーバー情報を入力します。

{
  "lucene-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AIエージェントはこのMCPの全機能にアクセスできるようになります。必ず “lucene-mcp” を実際のMCPサーバー名に、URLをご自身のMCPサーバーURLに置き換えてください。

概要

公開情報に基づくと、MCP Luceneサーバーはドキュメント検索と管理のための強力な基盤を提供していますが、プロンプトテンプレートやリソース、ルーツ、サンプリング等の明示的な対応はありません。MCPサーバーとしてのセットアップや利用方法はよくまとまっています。

当社の見解

MCP Luceneサーバーは、エンタープライズ向けの検索・ドキュメント管理のための堅牢で実用的なMCP実装です。ただし、プロンプトテンプレートやリソース定義、高度なMCP機能（ルーツやサンプリング）の不足により、より複雑なエージェンティックなワークフローへの柔軟性は限定的です。Luceneによる検索をAIシステムへ統合する出発点としては非常に優れています。MCPスコア：6/10

MCPスコア