Vibe Math Mcp

Vibe Math MCP

一款高性能的模型上下文协议（MCP）服务，让你在和大模型一起畅聊时进行数学运算。它基于 Polars、Pandas、NumPy、SciPy 和 SymPy 构建，兼具出色的计算速度与全面的数学能力，涵盖基础算术、高等微积分和线性代数。

功能

21 种数学工具，覆盖 6 个领域，并支持批量编排：

• 基础计算（4 种工具）：表达式求值、百分比、舍入、单位换算
• 数组运算（4 种工具）：逐元素运算、统计、聚合、转换
• 统计学（3 种工具）：描述性统计、数据透视表、相关性
• 金融数学（3 种工具）：货币时间价值、复利、永续年金
• 线性代数（3 种工具）：矩阵运算、方程组求解、分解
• 微积分（3 种工具）：导数、积分、极限与级数
• 批量执行（1 种工具）：为复杂工作流编排多个工具

安装

IDE

Claude Desktop

打开 设置 > 开发者 > 编辑配置，并添加：

使用已发布的软件包：

{
  "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

快速设置（命令行）：

已发布的软件包：

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

团队设置（在项目根目录创建 .mcp.json，供 Claude Code 和/或 IDE 共享使用）

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

**验证：**运行 claude mcp list，或使用 /mcp，也可以在 IDE 中查看可用服务。

试用

• “计算 250 的 15%” → 使用 percentage
• “求 [[1,2],[3,4]] 的行列式” → 使用 matrix_operations
• “计算 x^2 从 0 到 1 的积分” → 使用 integral
• “如果我以 5% 的年利率按月复利投资 $1000，持续 10 年，未来价值是多少？” → 使用 compound_interest
• 如果我在 10 年后获得 $69m 的平方根作为报酬，按 7% 的折现率计算，其现值是多少？→ 使用 batch_execute (calculate -> financial_calcs)

输出控制

所有工具均自动支持输出控制，兼顾灵活性和令牌效率。大模型可以指定所需的详细程度。

使用 output_mode 参数控制响应详细程度（每个工具均可使用）：

模式	描述	令牌节省量	适用场景
full	包含所有元数据的完整响应（默认）	0%（基准）	调试，需要完整上下文
compact	移除空值字段，尽量减少空白	~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、Cholesky、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. 代码经过 lint 检查并完成格式化
3. 包含类型提示
4. 提供清晰、可操作的错误消息

支持

如有问题或疑问，请在 GitHub 上提交 issue。