Partuno — DigiKey & Mouser MCP Server

Partuno - DigiKey & Mouser MCP サーバー

MCP 向けのローカルファーストな電子部品情報

Partuno は、電子部品の調査、BOM 分析、調達先の比較、安全な販売代理店ワークフローに対応した、オープンソースでプロバイダーに依存しないローカルファーストの Model Context Protocol（MCP）サーバーです。共有認証情報や自動発注を使わずに、お使いの DigiKey および Mouser の認証情報を AI アシスタントに接続できます。また、根拠、正規化された属性、明示的な不確実性を確認できます。

Partuno は当初、ネイティブ MCP サーバーとして開発されました。通常の ChatGPT の会話でアプリとして動作し、より豊富なツールアノテーションを公開するため、ネイティブ MCP による接続を推奨します。既存の Custom GPT Action エンドポイントも後方互換性のために引き続き利用でき、/action-openapi.json も含まれます。

Partuno は、共有の公開サーバーや共有の販売代理店認証情報を提供しません。Render の設定は、運用者自身が使用する単一ユーザーインスタンス向けの、任意のリファレンスデプロイです。

まずはこちら

公開済みパッケージを使用する（推奨）

Partuno は PyPI で公開されており、公式 MCP Registry に掲載されています。推奨するローカル MCP ランチャーは次のとおりです。

uvx --from partuno partuno-mcp

これにより、公開済みの最新リリースがダウンロードされ、デフォルトのローカル stdio トランスポートで実行されます。現在のリリースを厳密に固定するには、次を使用します。

uvx --from 'partuno==4.0.1' partuno-mcp

ローカルコマンドを受け付ける MCP クライアントでは、次の引数を指定して uvx を使用できます。

{
  "command": "uvx",
  "args": ["--from", "partuno", "partuno-mcp"]
}

運用者自身が所有する DigiKey および Mouser の認証情報は、MCP クライアントの環境変数に設定してください。対応する変数についてはローカルデプロイガイドを、運用者自身が管理するリモートデプロイについてはネイティブ MCP セットアップガイドを参照してください。ホスト型ディレクトリの掲載情報については、Glama の Partunoを参照してください。

pip でインストールする

uvx が利用できない場合は、公開済みパッケージを既存の Python 環境にインストールします。

python3 -m pip install partuno
partuno-mcp

git clone https://github.com/JPMarhefka/partuno.git
cd partuno
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
cp .env.example .env
set -a
source .env
set +a
python -m partuno

リモート MCP サーバーをセルフホストする

クライアントが到達可能な HTTPS エンドポイントを必要とする場合は、ご自身のプロバイダーアカウント、OAuth アプリケーション、署名キー、レート制限、ホスティング予算を使用して、独自のインスタンスをデプロイしてください。Render リファレンスデプロイから始めるか、Docker および Azure のガイドを利用してください。公開利用を目的とした共有 Partuno エンドポイントはありません。

既存の Action 互換インターフェースを使用する

既存の連携向けに Custom GPT Actions は引き続き利用できます。Action/OpenAPI インターフェースは主要なアーキテクチャではありません。新しい接続にはネイティブ MCP を使用してください。Action のセットアップ手順は MCP セットアップに記載されています。

Partuno の機能

• DigiKey と Mouser の電子部品を検索して調査します。
• メーカー型番、単位、適合性の値、販売代理店ごとに異なる一般的な属性名を正規化します。
• 指定数量における正確な部品のオファーを比較します。価格段階、最小注文数量、注文単位、在庫状況、プロバイダーの部分的な障害も考慮します。
• meets、does_not_meet、unknown の証拠状態を維持しながら、必須要件に合う部品を推奨します。
• BOM の在庫状況、ライフサイクル、適合性、価格、関税、リードタイム、代替候補を分析します。
• 読み取り専用の注文履歴、リストや見積もりのプレビュー、受け入れ照合、プロバイダーが対応する場合の慎重な確認を伴う変更など、範囲を限定したアカウントおよびプロジェクトのワークフローに対応します。

現在の対象範囲と各ワークフローの安全境界については、機能リファレンスをご覧ください。

DigiKey MCP サーバー

Partuno は、部品検索、製品調査、最新価格と在庫状況、ライフサイクル確認、MyLists、見積もり、受け入れ照合、その他の範囲を限定したアカウントワークフローに対応する、ローカルファーストの DigiKey MCP サーバーとして実行できます。DigiKey MCP サーバーガイドでは、セットアップ方法、対応するワークフロー、プロバイダー固有の安全境界について説明しています。

Mouser MCP サーバー

Partuno は、カタログ検索、正確なオファーの比較、読み取り専用の注文履歴、プレビュー確認を伴うカートのワークフローにも対応する Mouser MCP サーバーの機能を提供します。Mouser MCP サーバーガイドでは、運用担当者が管理する Mouser 認証情報と、サーバーが実行する処理、実行しない処理について説明しています。

電子部品 BOM MCP サーバー

Partuno を電子部品 BOM MCP サーバーとして使用すると、重複行の統合、製品の正確な特定、現在の製品コストの見積もり、在庫状況とライフサイクルリスクの確認、適合性とリードタイムの兆候の調査、代替品や別のパッケージの検索ができます。読み取り専用の完全な例と既知の制限については、電子部品 BOM MCP サーバーガイドをご覧ください。

AI による部品調達

Partuno は、自然言語によるエンジニアリング依頼を、追跡可能な調達ワークフローに変換します。推奨では meets、does_not_meet、unknown の証拠状態を維持するため、欠落または曖昧な属性が、適格要件を満たしていると暗黙に判断されることはありません。意図するやり取りのスタイルについては、自然言語の例をご覧ください。

DigiKey と Mouser の比較

正確な比較では、まずメーカーと MPN の同一性を照合し、その後、指定数量での価格、最小注文数量、注文単位、購入可能数量、在庫状況、メーカーのリードタイムを比較します。プロバイダーで障害が発生した場合や、証拠が不完全な場合は、勝者を作り上げず、結果を部分的なものとして扱います。DigiKey と Mouser の比較ガイドをご覧ください。

Partuno が行わないこと

• DigiKey または Mouser の認証情報は提供しません。
• 複数のテナントで共有する認証情報プールは作成しません。
• 不明な製品データを、合格として暗黙に扱うことはありません。
• 販売代理店への注文は送信しません。
• プロバイダーの利用制限、利用規約、認証、レート制限を回避しません。

動作を見る

注目の例：3.3 V 設計に使用する部品を選ぶ

Partuno を接続すると、ユーザーは次のように尋ねるだけで済みます。

I’m choosing a dual op amp for a 3.3 V circuit. Find a few LM358-family
options that can operate at 3.3 V, are RoHS compliant, normally stocked, and
available in a quantity of 10. Show the evidence behind each recommendation
and keep uncertain data clearly marked.

Partuno は、この自然言語によるリクエストを、条件を満たす候補、未検証の候補、却下された候補を含む、プロバイダーを考慮した結果に変換します。正規化された電圧と適合性の根拠、複数の販売代理店にまたがる在庫状況、数量別価格、パレート方式による候補リストも提示します。仕様が欠落している場合、それを暗黙に合格として扱うことはありません。

これは、リクエストと滑らかな応答のスクロールを示す、プロンプトから結果までのおよそ 10 秒のキャプチャです。価格、在庫、納期はプロバイダーから取得したライブデータであり、変更される場合があります。

比較、製品調査、BOM レビュー、安全なアカウントプレビューのワークフローについては、自然言語の使用例をご覧ください。

ドキュメント

ロゴ素材

高解像度の Partuno ロゴは、プロジェクトページ、クライアント一覧、統合ドキュメントで使用できます。PNG のサイズ制限が厳しいクライアントやプラグインのアップロード欄向けに、コンパクトなプラグインアイコンも用意されています。

コンパクトなアイコンは、アップロードサイズの上限が小さい場合に適するよう最適化されています。ホストがより大きな素材を受け付ける場合は、代わりに高解像度のロゴを使用してください。コンパクトなアイコンは、リポジトリの素材の生 URLから直接ダウンロードすることもできます。

ChatGPT アプリ、MCP クライアント、その他のプラグイン統合でロゴを使用する場合は、統合を Partuno として明示し、DigiKey、Mouser、その他のプロバイダーによる推奨を示唆しないでください。アップロードする前に、ホストプラットフォームの最新の寸法、形式、ファイルサイズの要件を確認してください。

デプロイと認証情報のモデル

リモートモードでは、ホストされた MCP エンドポイントがクライアントを認証し、上流へのアクセスを保護するために、OAuth と HTTPS が追加されます。これは任意です。ローカルモードが引き続きデフォルトであり、Partuno OAuth は不要です。

プロジェクトの状況

Partuno 4.0.1 は、現在も開発が続くオープンソースリリースです。テストスイートでは、オフラインのプロバイダー契約、MCP ツールの動作、REST 互換性、認証情報の安全性、正規化、複数の販売代理店にまたがるワークフローを網羅しています。ライブのプロバイダー呼び出しは、オペレーターの認証情報が必要で、プロバイダーのクォータ制限の対象となるため、明示的に有効化した場合のみ実行されます。

ライブスモークテストを実行する前に、テストをご覧ください。

ライセンスと独立性

Partuno は Apache License 2.0 に基づいて公開されています。プロジェクトの帰属および独立性に関する声明については、NOTICE をご覧ください。Partuno は、DigiKey、Mouser、または本プロジェクトに記載されているメーカーや販売代理店のいずれとも提携しておらず、承認や後援も受けていません。これらの名称およびマークは、連携先を示す目的でのみ使用されています。