VKey Calculator MCP

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

功能特性

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

安装

方法一：使用 uv（推荐）

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

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

方法二：本地安装

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

# 安装项目
pip install -e .

# 运行
python -m vkey_calculator_kel

MCP 配置

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

{
  "mcpServers": {
    "vkey_calculator_kel": {
      "command": "uvx",
      "args": [
        "vkey_calculator_kel@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               # 项目说明

构建

# 构建包
uv run -m build

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

许可证

MIT License