systemlink-mcp

NI SystemLink をAIクライアントに公開するMCPサーバーで、テスト・計測に特化したツールを備えています。製品リビジョン別の歩留まり、規格限界に対する不合格DUTステップ、測定トレースの要約、校正期限切れのアセットなどに対応します。

これはdaq-mcpのフリート/データ層のコンパニオンです。daq-mcpは単一のDAQデバイスと通信します。systemlink-mcpはラボ全体の結果、アセット、システムを照会し、関連付けます。

これは個人プロジェクトであり、メンテナーは1名です。NI製品ではありません。NI / Emersonとの提携、承認、サポートは一切ありません。

汎用ラッパーではなくテストドメインツールを選ぶ理由

商用ミドルウェアカタログは、SystemLinkを何千もの産業システムの中に列挙し、CMMS/ERP型のサーフェス（作業指示、サイト、スペース、販売注文）を公開できます。その抽象化では、テストエンジニアが実際に問いかける質問に答えられません。

• 今四半期の製品リビジョンBの合格/不合格率

• 不合格DUTのどの測定が限界を超えたか

• 校正期限を過ぎたPXIモジュールはどれか

ここにあるすべてのツールは、そうした質問に合わせて設計されています。応答はサマリーと制限付きプレビューであり、生のTest MonitorやDataFrameのペイロードではありません。数千行の結果行や2000ポイントの波形をモデルコンテキストに流し込むと、API呼び出しが正しくてもサーバーは使えなくなります。

Related MCP server: Auto-Manager MCP

デフォルトで読み取り専用

変更を伴うツール（update_result_properties、execute_notebook）は、SYSTEMLINK_MCP_ALLOW_WRITE=1が設定されていない限り拒否します。読み取りツールは追加フラグなしで動作します。

現在のnisystemlink-clientsのAssetManagementClientには、作成、クエリ、削除、ファイルリンク、利用状況のメソッドがありますが、アセット更新メソッドはありません。したがって、ゲート付きの書き込みサーフェスは、Test Monitorの結果メタデータの更新とノートブック実行のキュー登録を行い、アセットレコードは更新しません。

スタック

Python 3.11+、uv、FastMCP（stdioまたはStreamable HTTP）、Pydantic v2、公式のnisystemlink-clientsパッケージ。ツールはSDKをインポートせず、SystemLinkBackendを呼び出します。SYSTEMLINK_MCP_SIMULATE=1を設定すると、SystemLinkサーバーを必要としない純Pythonのフェイクが使われます。

クイックスタート（SystemLinkサーバーなし）

uv sync
SYSTEMLINK_MCP_SIMULATE=1 uv run server.py

PowerShell:

$env:SYSTEMLINK_MCP_SIMULATE="1"; uv run server.py

実際のSystemLink

シミュレートされたバックエンドは、SYSTEMLINK_MCP_SIMULATE=1が設定されている場合、またはライブ接続に失敗しSYSTEMLINK_MCP_REQUIRE_REALが未設定の場合にのみ使用されます。ライブ応答には"backend": "systemlink"と"simulated": falseが含まれます。

1. SystemLinkでAPIキーを作成します（Enterprise: ポリシー、次にAPIキー。SDKが送信するHTTPヘッダーはx-ni-api-keyです）。SLEはプログラムによるアクセスにユーザー名とパスワードを受け付けません。

2. .env.exampleを.env（gitignore対象）にコピーし、以下を設定します:

SYSTEMLINK_SERVER_URI=https://your-systemlink-host
SYSTEMLINK_API_KEY=...
SYSTEMLINK_MCP_REQUIRE_REAL=1

SYSTEMLINK_MCP_SIMULATEは設定しないでください。基本認証をまだ許可しているオンプレミスのSystemLink Serverでは、キーの代わりにSYSTEMLINK_USERNAME / SYSTEMLINK_PASSWORDを使用できます。SystemLink CloudはAPIキーのみで使用できます（URIなし）。その場合、バックエンドはCloudHttpConfigurationを構築します。

3. MCPの前にプローブを実行して、ログイン失敗が静かにフェイクフリートに変わらないようにします:

uv run server.py --probe

"simulated": falseと、サーバーからの短いquery_systemsプレビューが表示されるはずです。その後、シミュレートフラグなしでMCPを起動するか、Cursorを.cursor/mcp.json.live.exampleに向けます。

--probeが失敗した場合、JSONエラーはSDK（ApiException / 接続）からのものであり、ダミーデータからのものではありません。

ツール

MCP Inspector

リポジトリのルートから、シミュレーションを強制して:

SYSTEMLINK_MCP_SIMULATE=1 npx -y @modelcontextprotocol/inspector uv run server.py

PowerShell:

$env:SYSTEMLINK_MCP_SIMULATE="1"
npx -y @modelcontextprotocol/inspector uv run server.py

表示されたURL（通常はhttp://127.0.0.1:6274）を開きます。12個のツールが表示されることを確認し、group_by=part_numberを指定してsummarize_yieldを呼び出します。

stdioの代わりにStreamable HTTP:

SYSTEMLINK_MCP_SIMULATE=1 uv run server.py --http

MCPエンドポイントはhttp://127.0.0.1:8000/mcpです。transport="sse"は使用しないでください。そのトランスポートは非推奨です。

Cursor

.cursor/mcp.json.example（シミュレーター）または.cursor/mcp.json.live.example（実サーバー）を使用します。マシンローカルの.cursor/mcp.jsonはgitignore対象です。

{
  "mcpServers": {
    "systemlink-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:/Users/folayaod/personal/systemlink-mcp",
        "server.py"
      ],
      "env": {
        "SYSTEMLINK_MCP_SIMULATE": "1"
      }
    }
  }
}

Claude Desktop

同じJSONブロックをclaude_desktop_config.jsonに:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

保存後、Claude Desktopを再起動します。

シミュレートされたフリートを試すプロンプト

1. 「部品番号PN-5164-Bの合格/不合格率は、他のリビジョンとグループ化するとどうなりますか？」

2. 「DUT-1001がBoardFunctional.seqで失敗しました。どのステップが失敗し、Gainは限界値とどのように比較されましたか？添付の測定トレースを要約してください。」

3. 「校正期限を過ぎた、または近づいているPXIアセットはどれですか。PXI Rack 1は接続されていますか？」

テスト

SYSTEMLINK_MCP_SIMULATE=1 uv run pytest

テストはシミュレートされたバックエンドのみを対象としています。SystemLinkへのネットワーク接続は開きません。

ステータス

個人プロジェクト、メンテナー1名。シミュレートされたバックエンドがサポートされている日常的なパスです。実際のバックエンドは、python-docs.systemlink.ioで文書化されたnisystemlink-clients 2.32.x APIと、ni/nisystemlink-clients-pythonソースに基づいて記述されています。このリポジトリのCIでは、ライブのSystemLink Enterpriseインスタンスに対して実行されていません。校正ステータスのAsset Dynamic LINQプロパティ名は、公式のAssetIdentifier例のPascalCaseスタイルに従います。ライブサーバーがそのフィルターを拒否した場合、それはDEVLOG.mdに文書化された既知の統合リスクです。