analog-circuit-simulate-mcp-server

analog-circuit-simulate-mcp-server

アナログ回路シミュレーション用の Model Context Protocol（MCP）サーバー

特長

• アナログ回路シミュレーションを実行するための MCP ツールを提供します
• シミュレーションを制御する REST API インターフェースを提供します
• パラメーター化された回路シミュレーションに対応しています
• シミュレーション結果を JSON 形式で返します

インストールガイド（Linux のみ）

1. ngspice をインストールします（シミュレーションバックエンドに必要です）。

   sudo apt-get install ngspice  # For Debian/Ubuntu systems
   

2. Python 3.8 以降がインストールされていることを確認し（.python-version ファイルを参照）、uv ツールをインストールします。

   pip install uv
   

3. 仮想環境を作成して有効化します。

   uv venv .venv
   source .venv/bin/activate  # Linux/macOS
   

4. 次のいずれかの方法で依存関係をインストールします。

   • uv を使った直接インストール：

     uv pip install -e .
     

   • uv でビルドしてからインストール：

     uv build && pip install dist/analog_circuit_simulate_mcp_server-${version}-py3-none-any.whl
     # or uv build && pip install dist/analog_circuit_simulate_mcp_server-${version}.tar.gz
     

   • 従来の pip インストール：

     pip install -e .
     

使用方法

サーバーの起動

サーバーを実行する方法はいくつかあります。

• uv run を使用する場合：

  uv run analog-circuit-simulate-mcp-server
  

• uvx を使用する場合（uvx のインストールが必要です）：

  uvx --from https://github.com/abelzhao/analog_circuit_simulate_mcp_server.git analog-circuit-simulate-mcp-server
  

NPX の設定

{
  "mcpServers": {
    "ngspice-mcp-server": {
      "command": "uvx",
      "args": [
        "http://${server_ip}:4044/mcp/"
      ]
    }
  }
}

設定オプション

サーバーの設定は .venv で変更できます。

• FASTMCP_PORT=4044
• FASTMCP_JSON_RESPONSE=True

開発ガイド

analog-circuit-simulate-mcp-server のプロジェクト構成

.
├── .gitignore
├── .python-version
├── high_pass_filter.cir         # Example circuit file
├── pyproject.toml              # Python project configuration
├── README.md                   # English documentation
├── README.zh-CN.md             # Chinese documentation
├── uv.lock                     # UV dependency lock file
├── build/                      # Build directory
└── src/                        # Source code directory
    └── analog_circuit_simulate_mcp_server/     # Main package source
        ├── __init__.py         # Package initialization
        ├── __main__.py         # CLI entry point
        ├── server.py           # MCP server implementation
        └── simulate.py         # Simulation logic

ファイルの説明

• high_pass_filter.cir：回路シミュレーションのデモ用サンプル回路ファイル
• src/analog_circuit_simulate_mcp_server/server.py：MCP サーバーの実装と REST API インターフェースを含みます
• src/analog_circuit_simulate_mcp_server/simulate.py：回路シミュレーションのロジックと結果処理を含みます
• pyproject.toml：Python パッケージのメタデータ、依存関係、ビルド設定を定義します

NPX

{
  "mcpServers": {
    "analog-circuit-simulate-mcp-server": {
      "command": "uvx",
      "args": [
        "http://${server_ip}:4044/mcp/"
      ]
    }
  }
}

テスト

テストスイートを実行します。

pytest

ライセンス

MIT ライセンス

本ソフトウェアおよび関連ドキュメントファイル（以下「ソフトウェア」）のコピーを入手するすべての人に対し、制限なくソフトウェアを取り扱う権利を無償で許可します。これには、ソフトウェアの使用、複製、変更、結合、公開、配布、サブライセンス、および販売が含まれますが、これらに限定されません。また、ソフトウェアを提供された人に同様の権利を許可することも認められます。ただし、以下の条件に従うものとします。

上記の著作権表示および本許諾表示は、ソフトウェアのすべてのコピーまたは実質的な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、および権利非侵害の保証を含むがこれらに限定されない、いかなる保証もありません。作者または著作権者は、契約、不法行為その他の行為に起因するかを問わず、本ソフトウェアまたはその使用、その他の取引に起因または関連して発生した、いかなる請求、損害その他の責任についても責任を負いません。