Vibe Math Mcp

Vibe Math MCP

LLM と一緒に雰囲気よく数学計算を行うための、高性能な Model Context Protocol（MCP）サーバーです。Polars、Pandas、NumPy、SciPy、SymPy を使用しており、最適な計算速度と、基本的な算術から高度な微積分や線形代数までの幅広い数学機能を備えています。

特長

6 分野にわたる 21 種類の数学ツール とバッチオーケストレーションを提供します。

• 基本計算（4 ツール）：式の評価、パーセンテージ、丸め、単位変換
• 配列操作（4 ツール）：要素ごとの操作、統計、集計、変換
• 統計（3 ツール）：記述統計、ピボットテーブル、相関
• 金融数学（3 ツール）：貨幣の時間価値、複利、永久年金
• 線形代数（3 ツール）：行列操作、連立方程式の求解、分解
• 微積分（3 ツール）：導関数、積分、極限と級数
• バッチ実行（1 ツール）：複雑なワークフロー向けの複数ツールのオーケストレーション

インストール

IDE

Claude Desktop

Settings > Developer > Edit Config を開き、次を追加します。

公開パッケージの場合：

{
  "mcpServers": {
    "Math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

ローカル開発の場合：

{
  "mcpServers": {
    "Math": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/vibe-math-mcp",
        "run",
        "vibe-math-mcp"
      ]
    }
  }
}

Claude Code

クイックセットアップ（CLI）：

公開パッケージ：

claude mcp add --transport stdio math -- uvx vibe-math-mcp

ローカル開発：

claude mcp add --transport stdio math -- uvx --from /absolute/path/to/vibe-math-mcp vibe-math-mcp

チームでのセットアップ（Claude Code や IDE で共有するため、プロジェクトのルートに .mcp.json を作成します）

{
  "mcpServers": {
    "math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

確認： claude mcp list を実行するか、/mcp を使用するか、IDE で利用可能なサーバーを確認します。

試してみる

• 「250 の 15% を計算して」→ percentage を使用
• 「[[1,2],[3,4]] の行列式を求めて」→ matrix_operations を使用
• 「0 から 1 まで x^2 を積分して」→ integral を使用
• 「年利 5% で毎月複利、10 年間、$1000 を投資した場合、将来価値はいくらですか？」→ compound_interest を使用
• 10 年後に $69m の平方根分を受け取る場合、割引率 7% での現在価値はいくらですか？→ batch_execute (calculate -> financial_calcs) を使用

出力制御

すべてのツールは、柔軟性とトークン効率を最大限に高めるため、出力制御に自動対応しています。LLM は希望する詳細度を指定できます。

output_mode パラメーター（すべてのツールで使用可能）を使用して、応答の詳細度を制御します。

モード	説明	トークン削減率	用途
full	すべてのメタデータを含む完全な応答（デフォルト）	0%（基準）	デバッグ、完全なコンテキストが必要な場合
compact	null フィールドを削除し、空白を最小限に抑えます	約20～30%	構造を維持しながら適度に削減する場合
minimal	主な値のみを返し、メタデータを除去します	約60～70%	高速な抽出、コンテキストを最小限にする場合
value	正規化された{value: X}形式の構造	約70～80%	一貫したチェーン処理、シンプルさを最大化する場合
final	順次チェーン処理向けに、最終結果のみを返します	約95%	単純な計算、予測可能な抽出

バッチ実行

複数ステップのワークフローでは、batch_executeを使って複数の計算を単一のリクエストで連結でき、トークンを90～95%削減できます。$operation_id.result構文で前の出力を参照すると、エンジンが依存関係の解決と並列実行を自動的に処理し、速度を高めます。

最適な用途： 債券価格の計算、財務モデル、統計パイプライン、複雑な変換

ツールの完全なリファレンス

注： すべてのツールパラメーターには、MCP インターフェース上で具体例を含む詳細な説明が用意されています。各パラメーターには、想定される形式、用途、サンプル値が示されているため、外部ドキュメントを参照しなくても使い方がわかります。

基本的な計算

ツール	説明
calculate	変数置換を使って数式を評価します
percentage	パーセンテージの計算（割合、増加、減少、変化）
round	高度な丸め処理（round、floor、ceil、trunc）
convert_units	単位変換（度 � ラジアン）

配列操作

ツール	説明
array_operations	要素単位の演算（加算、減算、乗算、除算、べき乗）
array_statistics	統計指標（平均値、中央値、標準偏差、最小値、最大値、合計）
array_aggregate	集計（積和、加重平均、内積）
array_transform	変換（正規化、標準化、スケーリング、対数）

統計

ツール	説明
statistics	包括的な分析（記述統計、四分位数、外れ値）
pivot_table	集計を伴うピボットテーブルを作成します
correlation	相関行列（Pearson、Spearman）

金融数学

ツール	説明
financial_calcs	貨幣の時間価値（PV、FV、PMT、IRR、NPV）
compound_interest	さまざまな頻度の複利計算

線形代数

ツール	説明
matrix_operations	行列演算（乗算、逆行列、転置、行列式、トレース）
solve_linear_system	Ax = b の連立方程式を解きます
matrix_decomposition	行列分解（固有値分解、SVD、QR、コレスキー分解、LU 分解）

微積分

ツール	説明
derivative	記号微分および数値微分
integral	記号積分および数値積分
limits_series	極限および級数展開

---

## Development

### Running Tests

```bash
# Install dependencies
uv sync

# Run all tests
uv run poe test

ローカル開発モード

STDIO モード（デフォルト — Claude Desktop、IDE 向け）：

uv run vibe-math-mcp

HTTP モード（コンテナーのテスト向け）：

uv run python -m vibe_math_mcp.http_server

ライセンス

MIT ライセンスです。詳細は LICENSE ファイルを参照してください。

コントリビューション

PR によるコントリビューションを歓迎します！以下を確認してください。

1. テストが通ること。該当する場合は、新しいテストも追加してください
2. コードにリンターを適用し、フォーマットを整えること
3. 型ヒントを含めること
4. 明確で実行可能なエラーメッセージを提供すること

サポート

問題や質問がある場合は、GitHub で issue を作成してください。