Metadata-Version: 2.4
Name: vkey-calculator-mcp
Version: 0.1.2
Summary: vkey mcp calculator
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.3
Requires-Dist: build>=1.2.2.post1
Requires-Dist: html2text>=2024.2.26
Requires-Dist: mcp[cli]>=1.2.0
Requires-Dist: requests>=2.32.3
Requires-Dist: twine>=6.1.0
Description-Content-Type: text/markdown

# VKey Calculator MCP

一个基于 MCP (Model Context Protocol) 的计算器服务器，提供数学计算功能。

## 功能特性

- **基础算术运算**：加法、减法、乘法、除法
- **高级数学运算**：幂运算、平方根、阶乘
- **错误处理**：除零检查等安全机制
- **MCP 协议**：支持与 MCP 客户端集成

## 安装

### 方法一：使用 uv（推荐）

```bash
# 克隆项目
git clone <repository-url>
cd vkey-calculator-mcp

# 安装依赖并运行
uv run -m vkey_calculator_kel
```

### 方法二：本地安装

```bash
# 克隆项目
git clone <repository-url>
cd vkey-calculator-mcp

# 安装项目
pip install -e .

# 运行
python -m vkey_calculator_kel
```

## MCP 配置

在你的 MCP 客户端配置文件中添加以下配置：

```json
{
  "mcpServers": {
    "vkey_calculator_kel": {
      "command": "uvx",
      "args": [
        "vkey-mcp-calculator@latest"
      ]
    }
  }
}
```

## 可用的计算工具

### 基础算术
- `add(a, b)` - 加法运算
- `subtract(a, b)` - 减法运算  
- `multiply(a, b)` - 乘法运算
- `divide(a, b)` - 除法运算（自动检查除零）

### 高级数学
- `power(base, exponent)` - 幂运算
- `sqrt(number)` - 平方根计算
- `factorial(n)` - 阶乘计算

## 开发

### 项目结构
```
vkey-calculator-mcp/
├── src/
│   └── vkey_calculator_kel/
│       ├── __init__.py      # 主入口
│       ├── __main__.py      # 模块入口
│       └── server.py        # MCP 服务器实现
├── pyproject.toml           # 项目配置
└── README.md               # 项目说明
```

### 构建
```bash
# 构建包
uv run -m build

# 安装开发版本
pip install -e .
```

## 许可证

MIT License
