计算工具MCP服务器

一个基于Java的迷你模型上下文协议(MCP)服务器,提供算术计算和技能指导获取功能,适用于AI客户端集成。

  • by mortengf
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 mortengf/calculator-mcp-server

使用说明

计算器mcp服务器

一个迷你Java模型上下文协议(MCP)服务器,它公开了两个工具:

  • calculate --执行算术运算(加、减、乘、除)
  • get_skill --返回使用指南 SKILL.md,帮助AI客户端了解如何最好地使用服务器

与 官方MCP Java SDK,使用stdio传输,因此可以直接连接到Claude Desktop。

项目结构

src/
  main/
    java/mortengf/ai/mcp/
      CalculatorMcpServer.java   # MCP server with two tools: calculate and get_skill
    resources/
      SKILL.md                   # Usage guidance returned by the get_skill tool

动机

迷你代理 实现了一个小型Java代理循环,直接调用Claude API CalculatorTool 使用Claude特定的JSON定义(input_schema).

此服务器解决了中发现的可移植性问题 mini-agent:工具现在以MCP标准格式定义,可以由任何兼容MCP的AI客户端使用,而不仅仅是Claude。

什么是技能?

技能是一种MCP工具,它返回指导而不是执行操作。当AI客户端连接到此服务器时,它可以调用 get_skill 了解如何最好地使用 calculate 工具。

指导生活在 SKILL.md (作为类路径资源打包到JAR中)——与Claude Desktop的内置技能系统使用的模式相同。

先决条件

  • Java 17+
  • Maven 3.6+
  • Claude Desktop(作为MCP工具连接服务器)

建筑

mvn package -q

连接到克劳德桌面

将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

"calculator": {
  "command": "/path/to/java",
  "args": ["-jar", "/path/to/calculator-mcp-server/target/calculator-mcp-server-1.0-SNAPSHOT.jar"]
}

替换 /path/to/java 输出为:

sdk home java 17.0.1-tem
# → /Users/mgf/.sdkman/candidates/java/17.0.1-tem/bin/java

重新启动Claude Desktop——您现在可以让Claude计算一些东西,它将使用您的工具。

示例

你: 1/0是什么?

克劳德: 不允许除以零。

你: 什么是(123*456)+(789/3)?

克劳德: 56,351