Mathematica MCP

🚀 Mathematica MCP Server

このプロジェクトは、Wolfram Mathematicaカーネルとやり取りするためのモデルコンテキストプロトコル（MCP）サーバーを提供します。これにより、大規模言語モデル（LLM）がセキュアなセッションベースの環境でWolfram言語コードを実行できるようになります。

animalidフォルダには、ユニークな動物ベースの識別子を生成するためのシンプルなツールが含まれています。LLMはしばしばUUIDを正しくコピーできないため、このツールはそれらをより正確に転記される可能性の高い動物をテーマにしたIDで置き換えます。

✨ 主な機能

提供されるツール

1. create_mathematica_session：新しいWolfram言語セッションを初期化し、ユニークなセッションIDを返します。
2. execute_mathematica_code：指定されたセッション内でWolfram言語コードを実行します。
3. close_mathematica_session：セッションを終了し、そのリソースを解放します。

📦 インストール

前提条件

• Python 3.10以上。
• uv Pythonパッケージマネージャー。(インストールガイド)
• Wolfram EngineまたはMathematicaのローカルインストール。wolframclientライブラリはこれが機能するために必要です。

インストールとセットアップ

1. セキュリティキーの設定：

   このサーバーは、セキュアなセッションIDを生成するために秘密キーを使用します。これを環境変数として設定する必要があります。

   export ANIMALID_SECRET_KEY='your-super-secret-and-long-key-here'
   

   注意：弱いキーを使用したり、スクリプトにハードコードしたりしないでください。

💻 使用例

このサーバーを使用するには、Claude for DesktopなどのMCP互換クライアントに接続する必要があります。

基本的な使用法

1. MCPクライアントの設定：

   クライアントのMCP設定ファイル（例えば、Claude for Desktopの場合はclaude_desktop_config.json）を開き、以下のサーバー設定を追加します。

   重要：/path/to/your/project/my_mcpを、このプロジェクトのディレクトリのシステム上の絶対パスに置き換えてください。

   {
     "mcpServers": {
       "mathematica": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/your/project/my_mcp",
           "run",
           "wolfram_mathematica.py"
         ],
          "env": {
               "ANIMALID_SECRET_KEY": "default-secret-key-for-dev"
             }
       }
     }
   }
   

   uv実行ファイルがシステムのPATHにない場合は、commandフィールドでuv実行ファイルの完全パスを使用する必要があります。これは、which uv（macOS/Linux）またはwhere uv（Windows）を実行することで見つけることができます。

📚 ドキュメント

スクリーンショット