Vibe数学MCP
](https://badge.fury.io/py/vibe-math-mcp) ](https://pypi.org/project/vibe-math-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
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. 测试通过,如果适用,将添加新的测试
1. 代码已过梁并格式化
1. 包括类型提示
1. 提供清晰、可操作的错误消息
## 支持
有关问题和疑问,请在GitHub上打开问题。