AI連携 & MCPサーバー活用ガイド
概要
「MrcResearch」は、オープン標準プロトコル MCP(Model Context Protocol)サーバー をローカルに内蔵しています。
Cursor、Claude Desktop、Windsurf などの外部AIクライアントやAIエージェントから、MrcResearch 内に蓄積された膨大な市場データベース・統計分析エンジン・スクレイピング予約キューへ直接接続し、自然言語の対話を通して高度な市場分析、お宝セラーの発掘、仕入れ判断、HTMLレポート出力などを自動実行させることができます。
最新AIモデルとローカルリサーチデータの融合
ローカルループバック通信(ポート 8490)により、外部にデータが漏洩することなく安全にAI連携が可能です。フリープラン利用中はステータスバーのMCP表示は非表示となり、設定画面でもロック表示されます。
エンドポイント仕様 & 3つの起動・操作ルート
MrcResearch の MCP サーバーは、以下の標準エンドポイントを提供しています。
操作ルート① ステータスバー(画面最下部)でのワンクリック操作
アプリの最下部ステータスバーに、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のポート番号も一致させてください。