miseport-mcp
Can generate deployable read-only MCP/REST distribution packages for hosting on the shop's own Cloudflare Pages site.
Supports importing Shopify product CSV data into MisePort catalogs for validation, normalization, search, and exposure through MCP/REST tools.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MisePort — 日本のEC商品カタログをAIエージェントにつなぐオープンソースMCP
日本の小さなお店を、AIエージェントへ。
日本語 · English · 公開デモ · MCP接続ガイド · 商店向けガイド(Alpha) · 実画面の日本語操作手順 · GitHub Issues
MisePort(ミセポート) は、日本のネットショップの商品情報を、AIエージェントが検索・参照しやすいカタログに整えるオープンソースツールです。
商品データ(CSV / JSON)を検証・正規化し、Model Context Protocol(MCP)、CLI、REST API、Schema.org JSON-LDを通じて利用できます。ショップ自身がデータを管理しながら、AIによる商品発見(Agentic Discovery / GEO)に対応するための仕組みを提供します。
まず試す
入口 | 内容 |
サンプル商品を日本語で検索し、価格・在庫記録・出典URLを確認 | |
公開デモのMCPエンドポイント( | |
商品検索・詳細取得・参考見積もりのAPIを試す | |
自分の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ツール | 機能 |
| カタログの概要を返す |
| 商品名・キーワード・条件で検索する |
| SKUから商品詳細・出典URL・更新日時を取得する |
| 記録されている在庫状態・数量を確認する |
| 数量を指定して参考金額を試算する(税・送料が未確定なら総額は |
| 欠落項目やデータの整合性をチェックする |
| Schema.org |
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Related MCP Servers
- AlicenseAqualityDmaintenanceRead-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.11MIT
- FlicenseNot gradedqualityDmaintenanceA read-only MCP server for querying product inventory, providing tools to retrieve product details and stock quantities.-
- FlicenseNot gradedqualityDmaintenanceEnables searching products, fetching item details, listing categories, and viewing seller profiles for Japanese marketplaces Mercari and Yahoo! Flea Market via MCP tools.-
- AlicenseNot gradedqualityCmaintenanceEnables read-only catalogue discovery through standard MCP tools for searching, batch lookup, and retrieving product/variant details with prices and availability.MIT