TinyFish Guided Research

TinyFish Guided Research MCP

TinyFish Search と Fetch の上にシンプルなリサーチワークフローを追加する MCP サーバーです。

推論はクライアントモデルが行います。サーバーはリサーチの実行状況を追跡し、検索と取得のフローを処理し、状態を保存して、エビデンスと引用を確認し、次に何をすべきかクライアントに伝えます。

サーバー内では LLM は動作しません。

仕組み

リサーチは通常、次のフローに従って進みます。

Research request
      ↓
Plan
      ↓
Search
      ↓
Review sources
      ↓
Fetch useful content
      ↓
Track claims and evidence
      ↓
Check what is supported or still missing
      ↓
Research the gaps
      ↓
Verify citations
      ↓
Finalize

検索結果は、最初からエビデンスとして扱われるのではなく、まず候補として扱われます。

また、同じソースが複数回数えられないように重複を処理します。同じ論文やソースが異なる URL やミラーを介して見つかった場合も対象です。

引用文は取得したソースの内容と照合されます。一方、文章が実際に主張を裏付けているかといった意味的な判断は、クライアントモデルに委ねられます。

相反するエビデンスは無視せず、リサーチの状態に保持されます。リサーチを確定する前に、引用も確認されます。

対応する内容

• 複数のステップにわたるリサーチ状態の管理
• TinyFish Search と Fetch の呼び出し
• ソースのスクリーニングと重複処理
• 主張とエビデンスの追跡
• 取得した内容との引用文の照合
• 相反するエビデンス
• リサーチの不足箇所と追加検索
• 引用の検証
• リサーチの予算と停止条件
• SQLite と PostgreSQL による永続化

クイックスタート

ホステッド

ホステッド MCP エンドポイントは次のとおりです。

https://tinyfish-guided-research-mcp.fastmcp.app/mcp

Streamable HTTP MCP サーバーとして使用してください。

ローカル

Python 3.11 以降と TinyFish API キーが必要です。

TINYFISH_API_KEY="your-api-key" uvx tinyfish-guided-research-mcp

MCP クライアント設定の例：

{
  "mcpServers": {
    "tinyfish-research": {
      "command": "uvx",
      "args": ["tinyfish-guided-research-mcp"],
      "env": {
        "TINYFISH_API_KEY": "your-api-key"
      }
    }
  }
}

互換性のためのエントリーポイントも利用できます。

uvx --from tinyfish-guided-research-mcp tinyfish-research-mcp

ストレージ

ローカルまたは単一インスタンスでの使用には SQLite が適しています。

export RESEARCH_DB_PATH="research_state.db"

ホステッド環境やマルチインスタンスのデプロイでは、PostgreSQL を使用してください。

export DATABASE_URL="postgresql://user:password@host:5432/database?sslmode=require"

複数のサーバーインスタンスから同じリサーチ状態にアクセスする場合は、PostgreSQL の使用をおすすめします。

配布

このサーバーは、PyPI、公式 MCP Registry、ホステッド Horizon エンドポイントから利用できます。

PyPI：

tinyfish-guided-research-mcp

MCP Registry：

io.github.MohdSaleh/tinyfish-guided-research

ホステッド MCP：

https://tinyfish-guided-research-mcp.fastmcp.app/mcp

開発

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/MohdSaleh/tinyfish-guided-research-mcp.git
cd tinyfish-guided-research-mcp
uv sync --all-extras

ローカルで実行します。

TINYFISH_API_KEY="your-api-key" uv run tinyfish-guided-research-mcp

チェックを実行します。

uv run ruff check .
uv run ruff format --check .
uv run pyright
uv run pytest
uv run python evals/run_evals.py
uv run pip-audit
uv build

通常のテストでは、実装とストレージ層を確認します。リサーチ評価では、ソースの重複、弱いエビデンス、引用文の不一致、置き換えられた主張、引用の網羅性などのケースを確認します。

次のコマンドで MCP ツールを確認することもできます。

npx @modelcontextprotocol/inspector \
  --cli uv run tinyfish-guided-research-mcp \
  --method tools/list

Horizon へのデプロイ

Prefect Horizon を使って独自のインスタンスをデプロイする場合は、次を使用してください。

Entrypoint:
src/tinyfish_research_mcp/server.py:mcp

Dependencies:
pyproject.toml

次を設定します。

TINYFISH_API_KEY
DATABASE_URL

ホステッド環境へのデプロイでは、ローカルの SQLite フォールバックではなく PostgreSQL を使用してください。

ライセンス

MIT