AI連携 & MCPサーバー活用ガイド

概要

「MrcResearch」は、オープン標準プロトコル MCP(Model Context Protocol)サーバー をローカルに内蔵しています。
Cursor、Claude Desktop、Windsurf などの外部AIクライアントやAIエージェントから、MrcResearch 内に蓄積された膨大な市場データベース・統計分析エンジン・スクレイピング予約キューへ直接接続し、自然言語の対話を通して高度な市場分析、お宝セラーの発掘、仕入れ判断、HTMLレポート出力などを自動実行させることができます。

PROプラン機能(無料試用期間中も利用可能)

最新AIモデルとローカルリサーチデータの融合

ローカルループバック通信(ポート 8490)により、外部にデータが漏洩することなく安全にAI連携が可能です。フリープラン利用中はステータスバーのMCP表示は非表示となり、設定画面でもロック表示されます。

SSE: 127.0.0.1:8490

エンドポイント仕様 & 3つの起動・操作ルート

MrcResearch の MCP サーバーは、以下の標準エンドポイントを提供しています。

MCP SSE エンドポイント http://127.0.0.1:8490/sse Cursor / Windsurf / Claude Desktop等用
MCP Streamable HTTP http://127.0.0.1:8490/mcp ストリーミングHTTP接続対応クライアント用
REST API ドキュメント http://127.0.0.1:8490/api/v1/docs REST API エンドポイント仕様リファレンス

操作ルート① ステータスバー(画面最下部)でのワンクリック操作

アプリの最下部ステータスバーに、MCPサーバーの稼働状態を示すバッジ(MCP: ON (:8490) または MCP: OFF)が常時表示されます(PROプラン契約時)。

左クリック(即時切り替え)

バッジを左クリックするだけで、MCPサーバーの即時起動(ON)および停止(OFF)を瞬時に切り替えられます。

右クリック(コンテキストメニュー)

  • ▶ MCPサーバーを起動 (ON) / ⏹ 停止 (OFF)
  • 📋 AI連携ガイド(Markdown)をコピー
  • 📋 SSE エンドポイントURLをコピー
  • 📋 Cursor / Windsurf 用 MCP設定JSONをコピー
  • 📋 Claude Desktop (mcp-remote) 用 設定JSONをコピー
  • ⚙️ MCP サーバー設定を開く...

操作ルート② 設定画面(「データ・AI機能」タブ)

左メニューの「設定」(または 11. 設定マニュアル)を開き、タブ4「データ・AI機能」のカード4「MCP サーバー連携設定(上級者向け)」から詳細な設定を行えます。

  • • 有効化トグル: MCP サーバー機能の有効/無効を切り替えます(初期値: OFF)。
  • • ポート番号指定: デフォルトの 8490 から 1024〜65535 の範囲で自由に変更可能。万が一ポート競合が発生した場合は空きポートへ自動フォールバックします。「デフォルトに戻す (8490)」ボタンでいつでも初期値へ復帰できます。
  • • AI連携ガイドのコピー: プロンプトやシステム指示に埋め込めるMarkdown仕様書をワンクリックでクリップボードへコピーできます。

操作ルート③ クイックショートカット

デスクトップアプリの画面左上メニューにあるアプリアイコン(ロゴ)を3秒間長押しすることでも、設定画面の「MCP サーバー連携設定」カードを直接開くことができます。

外部AIクライアント別の接続設定

ご利用のAIクライアントの設定ファイルに、以下のJSONコードを追加するだけで即座に接続できます。設定ファイル更新後、AIクライアントを再起動するかMCPサーバーの再読み込みを実行してください。

Cursor / Windsurf(SSE直接対応クライアント)

SSE直接接続

Cursor の設定(Settings → MCP)または設定ファイル(グローバル: ~/.cursor/mcp.json、プロジェクト: .cursor/mcp.json)に以下を記述します。

{
  "mcpServers": {
    "mrcresearch": {
      "url": "http://127.0.0.1:8490/sse"
    }
  }
}

Claude Desktop(mcp-remote 経由接続)

mcp-remote 経由

Claude Desktop はSSEサーバーへの接続にブリッジツールを使用します。Node.js(npx)がインストールされた環境で、claude_desktop_config.json に以下を記述します。

{
  "mcpServers": {
    "mrcresearch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:8490/sse"
      ]
    }
  }
}

「AI連携ガイド(Markdown)」をプロンプト・ルールに登録する

ステータスバーの右クリックや設定画面からコピーできる「AI連携ガイド(Markdown)」には、全21種のMCPツールの使い分け、定型プロンプトの呼び出し方、および内部データベースのスキーマ定義(search_items.status の '1'=出品中 / '2','3'=売切、秒単位Epoch秒の日時カラムなど)が網羅されています。

💡 プロジェクトの CLAUDE.md や .cursorrules に貼り付けておくことで、AIが的確なSQLやツール引数を一発で生成できるようになり、分析精度と回答速度が飛躍的に向上します。

利用可能なMCPツール(全21種)・プロンプト・リソース

AIクライアントから呼び出し可能な全21種のツール、5種類の定型分析プロンプト、4つのリソースが自動登録されます。

分類 ツール名 機能概要
自然言語対話 ask_market_assistant 市場統計と内蔵ナレッジを総合した自然言語質問応答
市場・統計分析 analyze_market_data 指定キーワードの相場価格、成約率、売上高、販売推移の多角分析
analyze_price_tiers 価格帯別の出品数・成約率ヒストグラム(最多成約ボリュームゾーンの特定)
analyze_sales_heatmap 曜日別・時間帯別の成約件数ヒートマップ(出品ゴールデンタイムの特定)
需要・クラスタ find_repeating_products 短期間に何度も売れているリピート爆売れ・定番高回転商品の検出
find_similar_product_clusters タイトル形態素や特徴量による類似商品のグループ化と相場比較
セラー発掘 discover_unresearched_sellers 未詳細調査の有望・爆売れお宝セラーのスコアリング発掘
get_seller_detail 特定セラーの推定月商、平均利益率、主力取扱ジャンル、評価推移
analyze_top_sellers ジャンル・キーワード内のトップセラーランキングと戦略比較
商品・画像検索 search_items_filtered 価格範囲・ステータス(出品中/売切)・いいね数・更新日での絞り込み検索
search_similar_images AIベクトルエンジン(MobileNetV3)を用いた類似画像・同一商品の検索
カート・お気に入り list_purchase_carts 仕入れ検討カートに登録中の商品一覧と見込み利益・ROIの確認
list_favorite_sellers お気に入り登録済みセラーの一覧と最新出品・売上モニタリング
スクレイピング trigger_scraping_search AIからアプリ本体のスクレイピング予約キューへ新規リサーチタスクを登録
get_scraping_queue_status 現在のバックグラウンドスクレイピングキューの進行状況と待機件数取得
レポート出力 generate_research_report 指定キーワードの包括的な市場調査サマリー(Markdown形式)の生成
export_html_market_report グラフ・表付きの自己完結型インタラクティブHTMLレポートファイルの出力
DB・診断 get_database_schema 蓄積データベース(SQLite)の全テーブル定義・カラム型・インデックス情報
query_database_readonly 安全な読み取り専用(SELECT)SQLの直接実行(複雑な自由集計に対応)
get_system_diagnostics DB容量、総レコード数、稼働メモリ、バックグラウンドスレッド状態の診断
search_system_docs プロジェクト内の仕様書・設計ドキュメントのキーワード検索

5つの定型プロンプト(MCP Prompts)

AIクライアントの「/」コマンド等から定型ワークフローを一発呼び出しできます。

  • • market_comprehensive_analysis: 市場総合分析(相場・成約率・競合度合いの徹底調査)
  • • discover_treasure_sellers: 未調査のお宝注目セラー発掘(高成約率セラーの抽出)
  • • seller_deep_dive: 特定セラー徹底解剖(仕入れ元予測や販売戦略の丸裸化)
  • • price_strategy_advisor: 出品価格戦略アドバイザー(最速成約・利益最大化価格の提案)
  • • sourcing_cart_review: 仕入れカート&お気に入りレビュー(仕入れリスクと期待ROI評価)

4つのMCPリソース(MCP Resources)

AIのコンテキストに常時参照情報としてマウントされます。

  • • mrc://schema: データベース構造およびカラム詳細仕様
  • • mrc://diagnostics: システム稼働状況・DBレコード統計情報
  • • mrc://overview: MrcResearch の機能概要および連携仕様
  • • mrc://guide: AI連携ベストプラクティスガイド(Markdown完全版)

セキュリティ設計 & バックグラウンド維持

ループバック限定 & Read-Only保護

  • • ローカル限定バインド: MCPサーバーはループバック(127.0.0.1)にのみバインドし、外部ネットワークからの直接アクセスを完全に遮断します。
  • • 安全なSQL実行エンジン: query_database_readonly ツールは厳格なAST解析により SELECT / WITH / EXPLAIN のみを受理します。INSERT / UPDATE / DELETE / DROP 等の破壊的クエリはSQLエンジンレベルで厳格にブロックされるため、AIの誤操作によるデータ消失リスクはありません。

システムトレイ常駐(作業中断ゼロ)

  • • 「×」ボタンでも終了しない: ウィンドウ右上の「×」ボタンを押しても、アプリは完全終了せずシステムトレイ(タスクトレイ)に格納されます。
  • • MCP連携&拡張機能連携の継続: アプリを最小化したまま、Cursor や Claude Desktop での対話リサーチや、ブラウザからのワンクリックリサーチをバックグラウンドで快適に継続できます。
  • • 完全終了の手順: アプリを完全に終了する場合は、タスクトレイ内のアイコンを右クリックして「終了」を選択してください。

トラブルシューティング

Q. AIクライアント側で「Connection refused」や「接続タイムアウト」になる

MrcResearch のステータスバーで MCP サーバーが MCP: ON (:8490) になっているかご確認ください。OFF の場合はバッジを左クリックして起動してください。
また、お使いのセキュリティソフトやファイアウォールがローカルポート 8490 へのループバック通信を阻害していないかも併せてご確認ください。

Q. ステータスバーに「MCP」バッジが表示されない

MCP サーバー機能は PROプラン(有料契約および無料試用期間中)対応 です。試用期間終了後のフリープラン利用中は表示されません。PROプランをご契約いただくことで即座に利用可能となります。

Q. ポート 8490 が他アプリケーションで使用されている

MrcResearch は起動時にポート 8490 が使用中であれば自動的に別の空きポートを選択して起動します。ステータスバーに表示されるポート番号(例: MCP: ON (:8491))を確認し、AIクライアント側の設定JSONのポート番号も一致させてください。

バージョン: 4.3.10 (2026-03-20)