使用说明
计算器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