1nce MCP Server

🚀 1NCE IoT プラットフォーム MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーを提供し、人工知能エージェントが自然言語で 1NCE の IoT 接続管理プラットフォームと対話できるようにします。

🚀 クイックスタート

この MCP サーバーは、大型言語モデル (LLMs) を 1NCE API に接続するミドルウェア層を提供し、IoT 接続の管理を可能にします。AI アシスタントは以下のことができます。

• 製品情報の取得
• 注文の管理
• SIM カードの状態の監視
• データと SMS のクォータの確認
• SIM 設定の更新
• 接続状態の確認

これらの機能により、AI エージェントは自然言語で IoT インフラストラクチャと対話し、接続されたデバイスの管理を簡素化できます。

✨ 主な機能

• 認証：OAuth 2.0 トークンに基づく安全な認証を使用し、1NCE API を利用します。
• 製品管理：利用可能な IoT 接続製品を照会します。
• 注文管理：注文の作成と追跡を行います。
• SIM 管理：SIM カードの監視と設定を行います。
• リソース：SIM の状態と製品データに直接アクセスします。
• プロンプト：一般的なタスク用の事前定義された対話テンプレートが用意されています。

📦 インストール

前提条件

• Python 3.8 以上
• FastMCP v2
• API クレデンシャルを持つ 1NCE アカウント

インストール手順

1. このリポジトリをクローンします。

git clone https://github.com/yourusername/1nce-mcp-server.git
cd 1nce-mcp-server

2. 必要な依存関係をインストールします。

pip install fastmcp httpx

3. 環境変数を設定し、あなたの 1NCE API クレデンシャルを使用します。

export ONCE_CLIENT_ID="your_client_id"
export ONCE_CLIENT_SECRET="your_client_secret"

💻 使用例

FastMCP を使用したインストール

FastMCP CLI を使用してこの MCP サーバーをインストールすることをおすすめします。

fastmcp install 1nce_mcp.py

これにより、Claude Desktop を含む互換性のある MCP クライアントからサーバーにアクセスできるようになります。

直接実行

開発またはテスト時には、サーバーを直接実行することができます。

python 1nce_mcp.py

クライアントを使用する

FastMCP クライアントを使用して、サーバーとプログラム的に対話することができます。

from fastmcp import Client

async with Client("1nce_mcp.py") as client:
    # すべての製品のリストを取得
    products = await client.call_tool("get_all_products")
    print(products)
    
    # SIM の状態を確認
    sim_status = await client.call_tool("get_sim_status", {"iccid": "your_sim_iccid"})
    print(sim_status)

📚 ドキュメント

利用可能なツール

製品ツール

• get_all_products() - 利用可能なすべての 1NCE 製品を取得します。

注文ツール

• get_all_orders(page, page_size, sort) - ページングを使用して注文のリストを取得します。
• get_order_by_number(order_number) - 特定の注文の詳細情報を取得します。
• create_order(products, delivery_address, customer_reference) - 新しい注文を作成します。

SIM ツール

• get_all_sims(page, page_size, query, sort) - フィルタオプション付きで SIM カードのリストを表示します。
• get_sim_details(iccid) - 特定の SIM の詳細情報を取得します。
• get_sim_status(iccid) - SIM の接続状態を確認します。
• get_sim_data_quota(iccid) - SIM の残りのデータクォータを確認します。