Soulver MCP Server

🧮 SoulverCore MCP服务器

 ](https://nodejs.org/)  

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

1. 安装依赖项

   npm install

1. 构建项目

   npm run build

1. 测试服务器

   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许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• SoulverCore -强大的自然语言数学引擎
• 模型上下文协议 -实现AI工具集成的协议
• 克劳德桌面 -AI助手平台

📞 支持

• 问题:
• 文档: MCP文件
• SoulverCore: 官方文件

______________________________________________________________________

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