mcpField
Y
Yacy Mcp Server

Yacy Mcp Server

ローカル
github.com/koosty検索052 週間前に更新
リポジトリ

Yacy Mcp Server について

Yacy Mcp Serverは、YaCyのウェブ検索APIをMCP対応のAIアプリに接続するMCPサーバーです。検索範囲や結果数を指定でき、YaCyのURLも設定できます。

主な機能

  1. 01YaCyによるウェブ検索
  2. 02クエリと結果数の指定
  3. 03ローカルまたはグローバル検索
  4. 04環境変数によるYaCy URL設定

活用シーン

  1. 01AIアプリからウェブページを検索
  2. 02ローカルリソースに検索を限定
  3. 03検索結果数を調整

MCP 対応

stdio経由でMCPクライアントにyacy-searchツールを提供し、YaCyを使ってウェブ検索を実行します。

#mcp#yacy#search#ai#model-context-protocol

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "yacy": {
      "command": "uvx",
      "args": [
        "yacy_mcp"
      ],
      "env": {
        "YACY_URL": "<YACY_URL>"
      }
    }
  }
}
起動コマンドuvx yacy_mcp
設定が必要な環境変数
YACY_URL

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiyacy_mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

YaCy MCP サーバー

YaCy のウェブ検索 API を使った検索を可能にする AI ツールを提供する、MCP（Model Context Protocol）サーバーの実装です。

インストール

  1. uv がインストールされていることを確認します。
pip install uv
  1. 開発モードでパッケージをインストールします。
cd yacy-mcp
uv sync  # Sync all dependencies from pyproject.toml and uv.lock

または、次の方法もあります。

cd yacy-mcp
uv pip install -e .

使用方法

  1. YaCy サーバーが実行中であることを確認します（通常は http://localhost:8090）。
  2. 環境変数を設定します（任意）。
export YACY_URL=http://localhost:8090
  1. MCP サーバーを実行します。
python -m yacy_mcp

設定

サーバーは環境変数を使って設定できます。

利用可能なツール

  • yacy-search：YaCy 検索エンジンを使って検索します。
    • パラメーター：
      • query（文字列、必須）：検索クエリ文字列
      • max_results（整数、任意）：返す検索結果の最大数（デフォルト：10）
      • resource（文字列、任意）：検索リソース（local または global、デフォルト：global）

AI アプリケーション向け MCP の設定

Model Context Protocol（MCP）に対応した AI アプリケーションでこのサーバーを使うには、stdio トランスポートを使ってサーバーに接続するよう、MCP クライアントを設定します。

Claude Desktop の設定例（settings.json）：

{
  "mcpServers": {
    "yacy-mcp": {
      "command": "uvx",
      "args": ["yacy_mcp"],
      "env": {
        "YACY_URL": "http://localhost:8090"
      }
    }
  }
}

その他の MCP 互換アプリケーションでは、サーバー実行ファイルとしてコマンド uvx yacy_mcp を使用してください。サーバーは PyPI から自動的に取得され、実行されます。

AI アプリケーションとの統合

この MCP サーバーは、Model Context Protocol に対応した AI アプリケーションで、YaCy 検索エンジンを使ったウェブ検索を実行するために利用できます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。