Metadata-Version: 2.4
Name: symath-mcp
Version: 0.1.0
Summary: Math MCP Server — symbolic computation, calculus, linear algebra, number theory, statistics, and unit conversion via MCP
Project-URL: Homepage, https://github.com/3aKHP/math-mcp
Project-URL: Repository, https://github.com/3aKHP/math-mcp
Project-URL: Changelog, https://github.com/3aKHP/math-mcp/blob/main/CHANGELOG.md
Project-URL: Bug Tracker, https://github.com/3aKHP/math-mcp/issues
Author: 3aKHP
License: MIT
License-File: LICENSE
Keywords: ai-agent,anthropic,calculus,claude,linear-algebra,math,mcp,mcp-server,model-context-protocol,statistics,symbolic-computation,sympy,unit-conversion
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: sympy>=1.12
Description-Content-Type: text/markdown

# Symath-MCP

[![PyPI](https://img.shields.io/pypi/v/symath-mcp)](https://pypi.org/project/symath-mcp/)
[![License: MIT](https://img.shields.io/github/license/3aKHP/math-mcp)](LICENSE)

**Language / 语言:** [English](#english) | [中文](#中文)

---

<a id="english"></a>

## English

Symath MCP Server — symbolic computation, calculus, linear algebra, number theory, statistics, and unit conversion via the Model Context Protocol.

### Quick Start

#### stdio (Claude Desktop / Claude Code)

```bash
pip install symath-mcp
```

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "math": {
      "command": "symath-mcp"
    }
  }
}
```

#### Streamable HTTP (server mode)

```bash
pip install symath-mcp
symath-mcp --transport streamable-http
```

Or with Docker:

```bash
docker compose up -d
```

The server listens on `http://127.0.0.1:5109/mcp` by default.

### Tools

| Tool | Description |
|------|-------------|
| `math_eval` | Evaluate mathematical expressions with arbitrary precision |
| `math_solve` | Solve equations and systems (algebraic, differential) |
| `math_calculus` | Integration, differentiation, limits, series |
| `math_matrix` | Eigenvalues, SVD, LU/QR decomposition, linear solve |
| `math_manipulate` | Simplify, expand, factor, partial fractions |
| `math_number_theory` | Prime factorization, GCD/LCM, Fibonacci, CRT |
| `math_statistics` | Descriptive stats, regression, probability distributions |
| `math_convert` | Unit conversion and physical constants |

### Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `HOST` | `127.0.0.1` | Bind address (streamable-http mode) |
| `PORT` | `5109` | Listen port (streamable-http mode) |

### License

MIT

---

<a id="中文"></a>

## 中文

Symath MCP 服务器 — 通过 Model Context Protocol 提供符号计算、微积分、线性代数、数论、统计和单位换算。

### 快速开始

#### stdio 模式（Claude Desktop / Claude Code）

```bash
pip install symath-mcp
```

在 MCP 客户端配置中添加：

```json
{
  "mcpServers": {
    "math": {
      "command": "symath-mcp"
    }
  }
}
```

#### Streamable HTTP 模式（服务器）

```bash
pip install symath-mcp
symath-mcp --transport streamable-http
```

或使用 Docker：

```bash
docker compose up -d
```

默认监听 `http://127.0.0.1:5109/mcp`。

### 工具列表

| 工具 | 说明 |
|------|------|
| `math_eval` | 计算数学表达式，支持任意精度 |
| `math_solve` | 求解方程/方程组（代数、微分） |
| `math_calculus` | 积分、求导、极限、级数展开 |
| `math_matrix` | 特征值、SVD、LU/QR 分解、线性方程组 |
| `math_manipulate` | 化简、展开、因式分解、部分分式 |
| `math_number_theory` | 质因数分解、GCD/LCM、斐波那契、中国剩余定理 |
| `math_statistics` | 描述性统计、回归、概率分布 |
| `math_convert` | 单位换算与物理常数查询 |

### 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `HOST` | `127.0.0.1` | 绑定地址（streamable-http 模式） |
| `PORT` | `5109` | 监听端口（streamable-http 模式） |

### 许可证

MIT
