UniFuncs MCP Server

UniFuncs MCP サーバー

UniFuncs API 用 MCP サーバー — Deep Search および Deep Research 機能を強化

機能

この MCP サーバーでは、以下の UniFuncs API を利用できます。

1. Web 検索（web-search）

包括的な検索結果を提供するリアルタイム Web 検索

• キーワードを使ってインターネット全体を検索
• 鮮度で絞り込み（Day／Week／Month／Year）
• ページネーションに対応（1 ページあたり 1～50 件）
• 複数の出力形式（JSON／Markdown／Text）

2. Web リーダー（web-reader）

Web ページから詳細なコンテンツを抽出

• クリーンなコンテンツ抽出
• 画像を任意で含める
• リンクの要約に対応
• Markdown 出力

3. Deep Search — 同期（deep-search-sync）

結果をすぐに取得できるリアルタイムの Deep Search

• モデル：S3／S3 Pro
• ストリーミングに対応
• 即時応答

4. Deep Search — 非同期（deep-search-create-task + deep-search-query-task）

複雑なクエリ向けの非同期 Deep Search

• タスクを作成し、すぐに task_id を取得
• タスクのステータスと結果をポーリング
• 大規模なクエリをバックグラウンドで処理

5. Deep Research（deep-research-create-task + deep-research-query-task）

包括的な Deep Research 機能

• モデル：U3、U3 Pro
• 調査パラメーターをカスタマイズ可能：
  • Introduction：調査担当者のペルソナを設定
  • Reference style：link／number／footnote
  • Max depth：最大 50 回の反復（推奨は 25 回）
  • Domain scope：検索対象を特定のドメインに制限
  • Domain blacklist：特定のドメインを除外
  • 出力プロンプトをカスタマイズ
  • 重要な URL、キーワード、プロンプト
• 非同期タスク管理

セットアップ

API キー

UniFuncs API キーを取得してください： https://unifuncs.com/account

NPX（STDIO）

{
    "mcpServers": {
        "unifuncs": {
            "command": "npx",
            "args": [
                "-y",
                "@unifuncs/ufn-mcp-server"
            ],
            "env": {
                "UNIFUNCS_API_KEY": "sk-**********"
            }
        }
    }
}

注：npx で利用できるのは npm に公開された最新パッケージであり、現在の main ブランチの内容とは異なる場合があります。npm に公開されたバージョンが main より古い場合は、最新のマージ済みツールセットを再現するため、以下のソースビルド手順を使用してください。

ソースビルド（ローカル）

git clone https://github.com/UniFuncs/ufn-mcp-server.git
cd ufn-mcp-server
yarn install
npm run build
UNIFUNCS_API_KEY=sk-********** node build/index.js

Codex MCP 設定の例：

[mcp_servers.unifuncs-local]
command = "node"
args = ["/absolute/path/to/ufn-mcp-server/build/index.js"]

[mcp_servers.unifuncs-local.env]
UNIFUNCS_API_KEY = "sk-**********"

SSE サーバー

SSE トランスポートを使用するには、環境変数を設定してください：

export UNIFUNCS_SSE_SERVER=true
export UNIFUNCS_SSE_SERVER_PORT=5656  # Optional, default is 5656

または、--sse フラグを使用してください：

npx @unifuncs/ufn-mcp-server --sse

ツールリファレンス

web-search

Query: Search keywords
Freshness: Day | Week | Month | Year (optional)
Page: Page number, default 1 (optional)
Count: Results per page, 1-50, default 10 (optional)
Format: json | markdown | text, default json (optional)

web-reader

URL: Page URL to read
Format: markdown (optional)
IncludeImages: boolean (optional)
LinkSummary: boolean (optional)

deep-search-sync

Model: s3 / s3-pro (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Stream: boolean (default: false)

deep-search-create-task

Model: s3 / s3-pro (default: s3)
Messages: Array of {role: "user"|"assistant"|"system", content: string}
Returns: task_id for querying status

deep-search-query-task

Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed

deep-research-create-task

Model: u3 | u3-pro (default: u3)
Content: Research question/topic
Introduction: Researcher persona (optional)
Reference_Style: link | number | footnote (default: link)
Generate_Summary: boolean (default: false)
Max_Depth: 1-50 (default: 25, recommended)
Domain_Scope: Comma-separated domains (optional)
Domain_Blacklist: Comma-separated domains to exclude (optional)
Output_Prompt: Custom output template (optional)
Important_URLs: Comma-separated URLs (optional)
Important_Keywords: Comma-separated keywords (optional)
Important_Prompt: Important prompt content (optional)
Push_To_Share: boolean (default: false)
Set_Public: boolean (default: false)
Returns: task_id for querying status

deep-research-query-task

Task_ID: Task ID from create_task
Returns: Task status, progress, and results when completed

使用例

Web 検索

{
  "query": "OpenClaw AI",
  "count": 5,
  "format": "json"
}

Deep Search（非同期）

// Create task
{
  "model": "s3",
  "messages": [
    { "role": "user", "content": "What are the latest developments in AI?" }
  ]
}

// Query task (use returned task_id)
{
  "task_id": "3aff2a91-7795-4b73-8dab-0593551a27a1"
}

Deep Research

// Create research task
{
  "model": "u3",
  "content": "Analyze the impact of AI on healthcare",
  "max_depth": 25,
  "domain_scope": "arxiv.org, nature.com",
  "generate_summary": true
}

// Query research task
{
  "task_id": "research-task-id-here"
}

料金

• Web Search：リクエストごとの従量課金
• Web Reader：リクエストごとの従量課金
• Deep Search：トークン使用量に応じた従量課金
• Deep Research：
  • U3：M トークン
  • U3 Pro：M トークン

詳しい料金については、https://unifuncs.com/pricing をご覧ください。

サポート

• ドキュメント：https://unifuncs.com/api
• GitHub：https://github.com/UniFuncs/ufn-mcp-server
• メール：[email protected]
• WeChat：unifuncs

メンテナー向けリリースチェックリスト

npx セットアップのセクションに新しいツールを記載する前に、npm パッケージが公開され、スモークテスト済みであることを確認してください。

1. パッケージのバージョンを上げます。
2. 依存関係をインストールし、npm run build を実行します。
3. パッケージを npm に公開します。
4. npm view @unifuncs/ufn-mcp-server version の結果が、リリース予定のバージョンと一致することを確認します。
5. npx -y @unifuncs/ufn-mcp-server で、この README に記載されているものと同じツールが利用できることを確認します。
6. npm でリリースが利用可能になった後、変更履歴と README を更新します。

ライセンス

MIT

変更履歴

v0.1.0（2026-02-25）

• Deep Search 同期 API のサポートを追加
• Deep Search 非同期 API（create_task + query_task）を追加
• Deep Research 非同期 API（create_task + query_task）を追加
• すべてのツールリファレンスを含むようドキュメントを拡充
• エラー処理を改善

v0.0.6

• web-search と web-reader を含む初回リリース