Skip to main content
Glama
miseport-mcp

miseport-mcp

by Siyuan-chat

MisePort — 日本のEC商品カタログをAIエージェントにつなぐオープンソースMCP

日本の小さなお店を、AIエージェントへ。

日本語 · English · 公開デモ · MCP接続ガイド · 商店向けガイド(Alpha) · 実画面の日本語操作手順 · GitHub Issues

CI License: Apache-2.0 Python 3.10+

MisePort(ミセポート) は、日本のネットショップの商品情報を、AIエージェントが検索・参照しやすいカタログに整えるオープンソースツールです。

商品データ(CSV / JSON)を検証・正規化し、Model Context Protocol(MCP)、CLI、REST API、Schema.org JSON-LDを通じて利用できます。ショップ自身がデータを管理しながら、AIによる商品発見(Agentic Discovery / GEO)に対応するための仕組みを提供します。

まず試す

入口

内容

ブラウザ公開デモ

サンプル商品を日本語で検索し、価格・在庫記録・出典URLを確認

MCP接続ガイド

公開デモのMCPエンドポイント(https://miseport.pages.dev/mcp)をクライアントに接続

REST API / OpenAPI

商品検索・詳細取得・参考見積もりのAPIを試す

ローカル実行(CLI / MCP)

自分のCSV / JSONを使って検証・検索し、MCPサーバーを起動

Related MCP server: inventory-mcp

設計の考え方

商品名の表記、税込・税抜価格、在庫状態、送料の扱いはショップによってさまざまです。MisePortは、AIエージェントが商品を比較・紹介するための情報を、出典・記録日時・未確認項目とともに整理します。

  • 出典と日時を残す: 商品ページのsource_urlとupdated_atを保持し、情報の参照元を辿れるようにします。

  • 不明な項目を推測で埋めない: 送料・税区分・在庫数が未確認なら、nullやunknownのまま扱います。

  • 日本語の商品を探しやすくする: 全角・半角、カタカナ・ひらがなを正規化して検索できます。

  • 読み取り専用(Read-Only by Design): 商品検索・詳細確認・参考見積もりに特化。購入手続きは元のショップの商品ページで行います。

  • ショップ主体のデータ管理: 各ショップが自分の環境で商品情報を管理・公開する、ローカルファーストの設計です。

カタログデータの例

サンプルカタログに含まれる架空の商品の例です。送料が不明な場合はnull、在庫を確認できない場合はunknownとして表します。

[
  {
    "sku": "tea-002",
    "name": "宇治 抹茶 30g",
    "price_jpy": 2200,
    "stock": "unknown",
    "tax_included": null,
    "shipping_jpy": null,
    "source_url": "https://example.com/products/tea-002",
    "updated_at": "2026-10-28T12:00:00+09:00",
    "is_demo": true
  }
]
ショップの商品CSV / JSON ──┐
BASE API・公式CSV(Alpha) ─┤
                           ▼
                 検証・正規化
                出典・日時の保持
                           ▼
                        MisePort
                 ├─ CLI(検索・監査・変換)
                 ├─ MCP(7つの読み取り専用ツール)
                 ├─ REST API / OpenAPI
                 └─ Schema.org JSON-LD
                           ▼
                AIエージェント/アプリ

データ形式の詳細はカタログ仕様をご覧ください。

ローカルで動かす

Python 3.10以上の環境で利用できます。リポジトリをクローンし、ルートディレクトリで実行してください。

git clone https://github.com/Siyuan-chat/miseport.git
cd miseport
python -m venv .venv
# macOS / Linux: source .venv/bin/activate
# Windows PowerShell: .venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

# 商品データの検証・検索・詳細表示
miseport validate examples/products.json
miseport search 抹茶 --catalog examples/products.json
miseport detail tea-002 --catalog examples/products.json
miseport inventory tea-002 --catalog examples/products.json

# CSV取込・参考見積もり・監査・JSON-LD出力
miseport import examples/products.csv --output catalog.json
miseport quote tea-002 --quantity 2 --catalog examples/products.json
miseport audit --catalog examples/products.json
miseport export-jsonld tea-002 --catalog examples/products.json

検索は表記揺れを正規化した部分一致方式です。カタログは最大10 MiB・10,000商品まで扱えます。詳しくはCLI / API仕様を参照してください。

AIエージェント/MCPクライアントに接続する

ローカルのmiseport-mcpはstdio通信に対応しています。MCPクライアントの設定ファイルで、カタログの絶対パスを指定します。

{
  "mcpServers": {
    "miseport": {
      "command": "miseport-mcp",
      "env": {
        "MISEPORT_CATALOG": "/absolute/path/to/examples/products.json"
      }
    }
  }
}

リモート接続には公開デモのStreamable HTTP MCPも利用できます。

MCPツール

機能

about_miseport

カタログの概要を返す

search_products

商品名・キーワード・条件で検索する

get_product

SKUから商品詳細・出典URL・更新日時を取得する

check_inventory

記録されている在庫状態・数量を確認する

get_quote

数量を指定して参考金額を試算する(税・送料が未確定なら総額はnull)

audit_catalog

欠落項目やデータの整合性をチェックする

export_product_jsonld

Schema.org Product / OfferのJSON-LDを生成する

Claude DesktopなどのMCP対応クライアントから利用できます。Meta MuseでもCustom Connector経由の接続例があります。詳しくはMuse接続ガイド · Agent評価(20件・実測範囲) · 自然発見E2実験とAgent GEOの考え方をご覧ください。

商店向けツール(Experimental / Alpha)

コマンドラインに慣れていないショップオーナー向けに、商品データの取り込みから確認、公開用パッケージの生成までを日本語で操作できるツールを開発しています。

  • 日本語ローカルGUI(miseport-gui): 商品の取り込み、更新差分のレビュー、公開前のチェック

  • ECプラットフォーム連携(Alpha): BASE v2 β APIからの商品読み込み、BASE / Shopifyの商品CSV取込、公開商品URLの確認補助

  • 配信パッケージ生成(miseport-publish): ショップ自身のCloudflare Pagesなどに公開できる、読み取り専用MCP / REST配信用ZIPの出力

現在は実店舗でのパイロット導入に向けて検証を進めています。操作方法や今後の開発については、商店向けAlphaガイド、対応プラットフォーム、ロードマップをご覧ください。

よくある質問(FAQ)

Q. 無料で使えますか?
はい。MisePortはApache-2.0ライセンスのオープンソースです。外部ホスティングサービスの費用は利用環境によって異なります。

Q. BASEやShopifyの商品データを使えますか?
標準のCSV / JSONに加え、Alpha機能としてBASE(API / CSV)とShopify(CSV)の読み込みに対応しています。

Q. AIエージェントから直接注文・決済できますか?
MisePortは商品情報の参照に特化したツールです。購入はショップの商品ページから行います。

ドキュメント・開発参加

公開ステータス · テスト/受入範囲 · 商品データ整合性の確認 · AI商品発見の準備診断 · API仕様 · データ形式 · Muse接続ガイド · Agent GEO · Cloudflareデモ · 製品方針 · セキュリティ · 貢献ガイド · ブランドガイド

バグ報告や機能提案はGitHub Issuesへお寄せください。

記載の会社名・サービス名は各社の商標または登録商標です。MisePortは独立したオープンソースプロジェクトであり、各プラットフォームの公式製品・提携サービスではありません。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server for searching Yahoo! Shopping products through the Yahoo! Shopping Item Search API v3. It supports keyword and JAN-code search with price, stock, condition, shipping, sorting, category, brand, seller, image-size, and pagination filters.
      1
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server for querying product inventory, providing tools to retrieve product details and stock quantities.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables searching products, fetching item details, listing categories, and viewing seller profiles for Japanese marketplaces Mercari and Yahoo! Flea Market via MCP tools.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only catalogue discovery through standard MCP tools for searching, batch lookup, and retrieving product/variant details with prices and availability.
      MIT