MCP Wolfram Alpha Server

MCP Wolfram Alpha サーバー

MCP Wolfram Alpha サーバーは、Wolfram Alpha API へのアクセスを提供する Go ベースの MCP サーバーです。MCP クライアント（Claude Desktop など）で、計算クエリの実行、科学データへのアクセス、構造化された知識の取得ができます。

この MCP サーバーの目的とメリット

目的

この MCP サーバーは、LLM（大規模言語モデル）が苦手とする数値計算タスクを、高精度な計算エンジンであるWolfram Alphaに委任します。

LLM の限界を理解する

LLM は、自然言語処理、テキスト生成、翻訳において優れた能力を発揮しますが、そのアーキテクチャは正確な数値計算や数式処理に最適化されていません。

• 計算精度： 基本的な暗算（例：2+3）を超えると、特に多桁の数値や複雑な数式（微積分、行列計算など）では、LLM が計算を誤る場合があります。
• トークン消費： LLM が複雑な計算を内部で試みる場合、多くの手順と推論が必要となり、貴重なトークン（計算リソース）を非効率に消費する可能性があります。場合によっては、正解にたどり着く前にトークン上限に達することもあります。

この MCP サーバーの役割とメリット

この MCP サーバーは、こうした課題に対処します。

• 高精度な計算： LLM が計算を必要とするタスクを受け取ると、計算部分をリクエストとしてこの MCP サーバーに送信します。サーバーはそのリクエストを Wolfram Alpha API に転送し、正確な計算結果を LLM に返すことで、ユーザーに信頼できる計算結果を提供します。
• LLM の負荷軽減： LLM は自ら計算する必要がなくなり、言語処理や文脈の理解といった得意分野に集中できます。
• トークン使用の最適化： LLM が不確実な計算を内部で試みた場合に発生する、非効率なトークン消費を防ぎます。 計算タスクを外部 API（この MCP サーバー経由の Wolfram Alpha）に委任することで、トークンの使用を API リクエストとレスポンスのやり取りに限定し、全体的により効率的な処理を実現します。

推奨されるユースケース

LLM が次のような計算を行う必要がある場合は、この MCP サーバーを積極的に活用することを推奨します。

• 算術演算（特に、桁数や小数の桁数が多いなど、簡単な暗算を超える計算）
• 代数方程式の解法
• 微分と積分
• 線形代数（行列計算など）
• 統計計算
• 物理学や化学の特定の公式を使った計算
• 単位や通貨の換算（特に、最新のレートが必要な場合）

ただし、1+1のようにLLMの能力で明らかに解ける非常に簡単な計算については、外部 API に問い合わせる必要はありません。 LLM が確実に処理できる計算は、そのまま実行してください。

結論として、この MCP サーバーは、LLM が計算精度とトークン効率の課題を克服し、より信頼性の高い効率的な回答を実現するための不可欠なサポートツールです。計算が必要な場合（非常に簡単な計算を除く）は、不要なトークン消費を避けるため、この MCP サーバー API を積極的に利用してください。

機能

• MCP への準拠：MCP 仕様に準拠した JSON-RPC ベースのインターフェースを実装
• Wolfram Alpha との連携：数学計算、科学データ、知識クエリへのアクセスを提供
• 設定可能なオプション：単位系、地域設定、言語オプションに対応

要件

• Go 1.24 以降
• Wolfram Alpha API ID（Wolfram Alpha Developer Portalから取得できます）

設定

サーバーは YAML ファイル（デフォルト：config.yml）で設定します。

log: 'path/to/mcp-wolfram-alpha.log' # Log file path (empty for no logging)
debug: false # Enable debug mode

wolfram:
  app_id: 'YOUR_WOLFRAM_ALPHA_APP_ID' # Required: Wolfram Alpha API ID
  timeout: 30 # API timeout in seconds
  use_bearer: false # Use Bearer token authentication
  default_max_chars: 2000 # Default maximum characters in responses

環境変数を使って設定を上書きできます。

• LOG_PATH：ログファイルのパス
• DEBUG：デバッグモードを有効にする（true/false）
• WOLFRAM_APP_ID：Wolfram Alpha API ID
• WOLFRAM_TIMEOUT：タイムアウト時間（秒）
• WOLFRAM_USE_BEARER：Bearer 認証を使用する（true/false）
• WOLFRAM_DEFAULT_MAX_CHARS：デフォルトの最大文字数

ビルドと実行

# Download dependencies
make deps

# Build the server
make build

# Run the server
./bin/mcp-wolfram-alpha server --config config.yml

MCP ツール

以下の MCP ツールが実装されています。

• wolfram_query：カスタマイズ用のオプションを指定して Wolfram Alpha のクエリを実行します

ツールの引数

wolfram_query ツールでは、以下の引数を指定できます。

{
  "query": "integrate x^2",
  "max_chars": 2000,
  "units": "metric",
  "country_code": "JP",
  "language_code": "en",
  "show_steps": true
}

• query（必須）：実行する Wolfram Alpha のクエリ
• max_chars：応答の最大文字数（デフォルト：2000）
• units：使用する単位系（metric または nonmetric）
• country_code：ローカライズ用の国コード（例：'JP'）
• language_code：ローカライズ用の言語コード（例：'ja'）
• show_steps：数学の問題について、段階的な解法をリクエストする（ブール値）

Claude Desktop での使用

Claude Desktop と連携するには、claude_desktop_config.json ファイルを編集します。

{
  "mcpServers": {
    "wolfram-alpha": {
      "command": "/path/to/bin/mcp-wolfram-alpha",
      "args": ["server", "--config", "/path/to/config.yml"],
      "env": {
        "LOG_PATH": "/path/to/logs/mcp-wolfram.log",
        "WOLFRAM_APP_ID": "YOUR_WOLFRAM_ALPHA_APP_ID"
      }
    }
  }
}

使用例

Claude Desktop を正しく設定すると、次のような質問を Claude にできます。

• "x^3 の導関数は何ですか？"
• "地球から火星までの距離を計算してください"
• "金の原子量は何ですか？"
• "100 キロメートルをマイルに換算してください"
• "方程式 x^2 + 3x - 4 = 0 を解いてください"

Claude はこの MCP サーバーを介して Wolfram Alpha API を自動的に使用し、回答を計算します。

エラー処理

サーバーは、さまざまな失敗状況に対して分かりやすいエラーメッセージを提供します。

• 認証エラー（無効な API ID）
• 無効な入力エラー
• ネットワーク接続の問題
• タイムアウトエラー
• Wolfram Alpha 側のエラー

トラブルシューティングに役立つ詳細情報とともに、すべてのエラーがログに記録されます。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

作者

cnosuke (github.com/cnosuke)