AI导哈

计算器服务

一个基于MCP协议的计算器服务，提供基本的算术运算功能，适用于需要远程调用计算功能的客户端应用。

  • by JRomeoSalazar
  • PHP
  • 本地部署
  • 更新于
在 GitHub 查看 JRomeoSalazar/mcp-calculator

使用说明

MCP计算器服务器

提供计算器功能的模型上下文协议（MCP）服务器。此服务器将基本算术运算作为MCP工具公开，任何兼容MCP的客户端都可以使用。

特性

  • 添加工具：将两个整数相加
  • 计算工具：执行基本算术运算（加、减、乘、除）
  • 配置资源：提供计算器设置（精度、负数支持）

需求

  • PHP 8.1或更高版本
  • 作曲家

安装

  1. 克隆存储库：
git clone https://github.com/YOUR_USERNAME/mcp-calculator.git
cd mcp-calculator
  1. 安装依赖项：
composer install

用法

运行MCP服务器：

php calculator.php

服务器通过stdio使用MCP协议（JSON-RPC消息）进行通信。

MCP工具

add

将两个数字相加。

参数：

  • a （整数）：第一个数字
  • b （整数）：第二个数字

退货： 整数和

calculate

执行基本算术运算。

参数：

  • a （number）：第一个数字
  • b （number）：第二个数字
  • operation （string）：要执行的操作(add, subtract, multiply, divide)

退货： 编号结果或错误消息

MCP资源

calculator_config

URI： config://calculator/settings

提供计算器配置设置，包括精度和负数支持。

建筑

此服务器使用 mcp/sdk 具有基于属性的发现的PHP库：

  • 装饰方法 #[McpTool] 自动显示为MCP工具
  • 装饰方法 #[McpResource] 作为MCP资源公开
  • PHPDoc注释提供了工具描述和参数文档

发展

添加新功能

要添加新的计算器工具，请执行以下操作：

  1. 将公共方法添加到 CalculatorElements 类在 src/Mcp/Calculator/CalculatorElements.php
  2. 用…装饰 #[McpTool] 属性
  3. 为描述和参数添加PHPDoc注释
  4. 使用类型提示自动生成架构

例子：

/**
 * Calculates the power of a number.
 *
 * @param float $base The base number
 * @param float $exponent The exponent
 * @return float The result
 */
#[McpTool]
public function power(float $base, float $exponent): float
{
    return pow($base, $exponent);
}

许可证

麻省理工学院

作者

豪尔赫·罗密欧

相关 MCP