AI导哈

数学计算协议服务器

一个高性能的数学计算协议服务器，提供从基础算术到高级微积分和线性代数的全面数学计算功能。

  • by apetta
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 apetta/vibe-math-mcp

使用说明

Vibe数学MCP

一个高性能的模型上下文协议（MCP）服务器，用于在与LLM交互的同时进行数学运算。使用Polars、Pandas、NumPy、SciPy和SymPy构建，可实现最佳计算速度和从基本算术到高级微积分和线性代数的全面数学能力。

特性

21数学工具 跨6个域+批处理编排：

  • 基本计算 （4个工具）：表达式求值、百分比、四舍五入、单位转换
  • 阵列操作 （4个工具）：元素操作、统计、聚合、转换
  • 统计 （3个工具）：描述性统计、数据透视表、相关性
  • 金融数学 （3个工具）：货币的时间价值、复利、永久性
  • 线性代数 （3个工具）：矩阵运算、系统求解、分解
  • 微积分 （3个工具）：导数、积分、极限和级数
  • 批处理执行 （1个工具）：用于复杂工作流的多工具编排

安装

月中日

克劳德桌面

打开 设置>开发人员>编辑配置 并添加：

对于已发布的包：

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

对于当地发展：

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

克劳德代码

快速设置（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

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

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

验证： 跑 claude mcp list 或使用 /mcp 或查看IDE中的可用服务器。

试试看

  • “计算250的15%”→ uses percentage
  • “找到行列式[[1,2],[3,4]]" → uses matrix_operations
  • “将x^2从0整合到1”→ uses integral
  • “如果我以5%的年利率每月复利投资1000美元，持续10年，未来的价值是多少？”→ uses compound_interest
  • 如果我在10年内获得6900万美元的平方根，那么按7%的折现率计算的现值是多少？ → uses batch_execute (calculate -> financial_calcs)

输出控制

所有工具都自动支持输出控制，以实现最大的灵活性和令牌效率。LLM可以指定所需的详细程度。

使用控制响应冗长度 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 高级圆角（圆形、地板、天花板、线槽）
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. 代码已过梁并格式化
  3. 包括类型提示
  4. 提供清晰、可操作的错误消息

支持

有关问题和疑问，请在GitHub上打开问题。

相关 MCP