Mcp Math Server

[![PyPI 版本](https://img.shields.io/pypi/v/mcp-math-server)](https://pypi.org/project/mcp-math-server/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-math-server)](https://pypi.org/project/mcp-math-server/)
[![许可证](https://img.shields.io/pypi/l/mcp-math-server)](./LICENSE)

---

## ✅ `README.md` for `mcp-math-server`

```markdown
# 📐 MCP 数学服务器

一个 [MCP (模型上下文协议)](https://modelcontextprotocol.io) 服务器，提供基本的算术运算——加法、减法、乘法和除法——以便轻松地与像 Claude 这样的 LLM 集成。

> 使用官方 `mcp` Python SDK 和 `FastMCP` 构建。

---

## 🚀 特性

- ✨ Claude/LLM 就绪的数学工具
- 🔢 四个核心运算：加、减、乘、除
- 🧠 专为无缝 MCP 集成而设计
- 🐍 通过 `mcp-math` 命令轻松使用 CLI

---

## 📦 安装

你需要 Python 3.10 或更高版本。

### 选项 1：从 PyPI (发布后)

```bash
pip install mcp-math-server

然后运行：

mcp-math

选项 2：从源代码 (用于开发)

git clone https://github.com/yourusername/mcp-math-server.git
cd mcp-math-server

# 推荐：使用 virtualenv 或 uv
python3 -m venv venv
source venv/bin/activate

pip install -e .
mcp-math

---

🧪 用法

运行 mcp-math 后，你的服务器将公开以下工具：

🔧 工具

工具	描述
add	将两个数字相加
subtract	从另一个数字中减去一个数字
multiply	将两个数字相乘
divide	将一个数字除以另一个数字

---

🤖 与 Claude Desktop 一起使用

1. 如果你还没有，下载 Claude Desktop。
2. 确保你的 MCP 服务器正在运行：

mcp-math

3. 在另一个终端中，将其注册到 Claude：

mcp install $(which mcp-math) --name "Math Assistant"

4. Claude 现在将显示“Math Assistant”作为可用的上下文/工具。

🧠 Claude 中的示例提示：

“使用 Math Assistant 中的 multiply 工具来计算 12 × 6。”

---

🧰 示例 MCP Inspector 测试

你也可以手动测试它：

mcp dev mcp_math/server.py

尝试调用：

{
  "tool": "divide",
  "arguments": { "x": 100, "y": 5 }
}

---

📁 项目结构

mcp-math-server/
├── mcp_math/
│   ├── __init__.py
│   └── server.py  # 所有 MCP 逻辑
├── pyproject.toml  # 包配置
├── README.md       # 你正在阅读此文件

---

🛠️ 开发

欢迎随意 fork 或 clone 此 repo 并添加更多数学工具、日志记录或上下文历史记录！

构建并发布到 PyPI：

pip install build twine
python -m build
twine upload dist/*

---

📃 许可证

MIT © 2025 Ajinkya 有关详细信息，请参见 LICENSE。

---

🙌 欢迎贡献

如果你有任何想法或改进，请随时提出 issue 或 pull request。 让我们一起让 LLM 更擅长数学！

---

## ✅ 你的下一步

- ✅ 将此 `README.md` 保存到你的根文件夹
- ✅ 替换占位符字段：
  - `https://github.com/yourusername/...`
  - 你的姓名 + 电子邮件
- ✅ 添加 `LICENSE` 文件（推荐 MIT — 我可以生成一个）

---

你希望我：
- 创建一个匹配的 `LICENSE` 文件吗？
- 帮助编写 `setup.cfg` 或 GitHub Actions CI 吗？
- 添加更高级的数学（例如，百分比、平方根）吗？

让我们不断提升它 🚀