AI导哈

自然语言数学计算服务

SoulverCore MCP Server是一个集成SoulverCore与Claude Desktop的MCP服务器，提供自然语言数学计算、单位转换、日期运算和金融计算功能。

  • by amotivv
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 amotivv/soulver-mcp-server

使用说明

🧮 SoulverCore MCP服务器

Claude桌面自然语言数学表达式评估

一个全面的模型上下文协议（MCP）服务器，集成了 SoulverCore Claude Desktop支持强大的自然语言数学计算、单位转换、日期算术和财务计算。

🤔 Soulver是什么？

索尔弗 是一款革命性的计算器，可以理解自然语言的数学表达式。与需要精确语法的传统计算器不同，Soulver允许您以自己的方式编写数学：

  • 自然语言：写 $25k over 10 years at 7.5% 而不是复杂的公式
  • 上下文感知：自动理解单位、货币、日期和百分比
  • 人类可读：结果的格式对人类有意义
  • 强大的发动机：处理复杂的财务、科学和日常计算

SoulverCore 是驱动此MCP服务器的命令行版本，将Soulver的自然语言数学功能带到了Claude Desktop。

🧠 为什么这有助于克劳德的数学

这种整合在几个关键方面显著提高了克劳德的数学能力：

🎯 精度和可靠性

  • 消除计算错误克劳德的内置数学有时会产生近似值或错误，尤其是在复杂的财务计算中。SoulverCore提供精确、可靠的结果。
  • 一致的结果：每个计算都由同一个经过验证的数学引擎处理，确保会话之间的一致性。

🌍 现实世界背景

  • 自然语言处理：Claude现在可以完全按照用户编写的方式处理数学请求，而无需转换为编程语法。
  • 单位情报：自动处理货币、计量、日期和百分比，无需手动转换。
  • 金融专业知识：Claude现在可以可靠地访问复利、贷款、提示和业务计算的专门功能。

📚 强化学习

  • 语法指导MCP资源为Claude提供了关于数学表达式模式的全面文档。
  • 错误解决：内置的故障排除指南可帮助Claude在计算不按预期工作时为用户提供帮助。
  • 示例库：大量的示例有助于Claude为复杂的计算提供正确的语法。

🔄 交互式工作流

  • 引导式计算：MCP Prompts为常见计算提供结构化模板，使Claude更容易帮助用户解决复杂问题。
  • 渐进式援助：Claude可以从简单的计算开始，并使用提供的示例构建更复杂的场景。

💡 为什么这很重要

在此整合之前，Claude可能会遇到以下问题：

  • 复杂百分比计算($150 is 25% on what)
  • 财务预测($25k over 10 years at 7.5%)
  • 带上下文的单位转换(65 kg in pounds)
  • 日期算术(January 30 2020 + 3 months 2 weeks 5 days)

现在克劳德可以自然准确地处理这些问题，使其成为解决现实世界问题的更可靠的数学助手。

✨ 特性

🛠️ MCP工具

  • calculate -评估自然语言数学表达式
  • soulver_status -检查SoulverCore CLI安装和版本

💬 MCP提示

  • compound_interest -使用引导输入计算复利
  • tip_calculator -计算包括小费在内的总成本
  • weight_conversion -在重量单位之间转换
  • date_addition -在日期中添加时间段
  • percentage_calculation -各种百分比计算

📚 MCP资源

  • 语法指南 -完整的SoulverCore语法参考
  • 快速参考 -常见语法模式
  • 财务示例 -现实世界的金融计算
  • 转换示例 -单位转换示例
  • 日期示例 -日期算术示例
  • 故障排除 -常见错误及解决方法

🚀 快速开始

先决条件

  • Node.js 18+
  • SoulverCore命令行界面 -安装方式： brew install soulver-cli
  • 克劳德桌面 支持MCP

安装

  1. 克隆存储库

    git clone https://github.com/amotivv/soulver-mcp-server.git
cd soulver-mcp-server

  2. 安装依赖项

    npm install

  3. 构建项目

    npm run build

  4. 测试服务器

    npm test

Claude桌面配置

将服务器添加到Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "soulver": {
      "command": "node",
      "args": ["/absolute/path/to/soulver-mcp-server/dist/index.js"]
    }
  }
}

重要：使用项目目录的绝对路径。

📖 使用示例

基本计算

Calculate: $25k over 10 years at 7.5%
→ $51,525.79

Calculate: 65 kg in pounds  
→ 143.3 lb

Calculate: $25/hour * 14 hours of work
→ $350.00

财务计算

Calculate: $150 is 25% on what
→ $600.00

Calculate: $10 for lunch + 15% tip
→ $11.50

Calculate: 40 as % of 90
→ 44.44%

日期算术

Calculate: January 30 2020 + 3 months 2 weeks 5 days
→ May 19, 2020

Calculate: 9:35am in New York to Japan
→ 10:35 pm

单位转换

Calculate: 32 fahrenheit in celsius
→ 0°C

Calculate: 10 miles in km
→ 16.09 km

🏗️ 建筑

graph TB
    A[Claude Desktop] -->|MCP Protocol| B[SoulverCore MCP Server]
    B -->|CLI Execution| C[SoulverCore CLI]
    B -->|Prompts| D[Interactive Templates]
    B -->|Resources| E[Documentation]
    B -->|Tools| F[Mathematical Engine]
    
    D --> G[Compound Interest]
    D --> H[Tip Calculator]
    D --> I[Unit Conversion]
    
    E --> J[Syntax Guide]
    E --> K[Examples]
    E --> L[Troubleshooting]
    
    F --> M[Expression Parser]
    F --> N[Result Formatter]

🔧 发展

项目结构

soulver-mcp-server/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── soulver-cli.ts        # CLI wrapper
│   ├── test.ts               # Test suite
│   ├── prompts/              # MCP prompt definitions
│   │   ├── financial.ts
│   │   ├── conversions.ts
│   │   └── dates.ts
│   └── resources/            # MCP resource definitions
│       ├── syntax-guide.ts
│       └── examples.ts
├── dist/                     # Compiled JavaScript
├── memory-bank/              # Project documentation
├── package.json
├── tsconfig.json
└── README.md

可用脚本

npm run build    # Compile TypeScript
npm test         # Run test suite
npm run dev      # Development mode (if configured)

测试

该项目包括一个全面的测试套件，用于验证：

  • ✅ SoulverCore命令行界面可用性
  • ✅ 数学表达式评估
  • ✅ 错误处理和边缘情况
  • ✅ MCP协议合规性
npm test

📋 支持的表达式类型

财务计算

  • 复利: $25k over 10 years at 7.5%
  • 小时工资: $25/hour * 14 hours of work
  • 提示: $10 for lunch + 15% tip
  • 百分比: 40 as % of 90, $150 is 25% on what

单位转换

  • 重量: 65 kg in pounds, 150 lbs in kg
  • 距离: 10 miles in km, 5 km in miles
  • 温度: 32 fahrenheit in celsius, 100 celsius in fahrenheit

日期算术

  • 加法: January 30 2020 + 3 months 2 weeks 5 days
  • 差异: December 31 2024 - January 1 2024
  • 时区: 9:35am in New York to Japan

基础数学

  • 算术: 100 + 200, 50% of 200
  • 货币: $100 + $50, €200 - €75

🛡️ 安全和错误处理

  • 输入消毒：所有表达式在执行前都经过验证
  • 进程超时：CLI调用在10秒后超时
  • 错误恢复：巧妙处理无效表达式
  • 资源管理：正确清理子进程
  • 类型安全：具有严格模式的完整TypeScript实现

🤝 贡献

  1. 分叉存储库
  2. 创建要素分支： git checkout -b feature/amazing-feature
  3. 提交您的更改： git commit -m 'Add amazing feature'
  4. 推到分支： git push origin feature/amazing-feature
  5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

📞 支持

由以下材料制成❤️ 克劳德桌面社区

⭐ 标记此回购 • 🐛 报告Bug • 💡 请求功能

相关 MCP