A simple calculator app using Model Context protocol

使用 Model Context protocol 构建的简易计算器应用

本仓库的目的

从零开始探索 MCP 的基本构建模块，以及 MCP 中工具调用的复杂之处。尽可能保持简单，不处理太多边缘情况。了解如何构建 MCP 服务和客户端。

核心功能

可进行加、减、乘、除和取模运算的计算器应用

使用 MCP Inspector 调试服务

基于 MCP 的客户端，可接收用户查询并执行上述运算

用于快速探索概念的未来可能性

顺序调用工具

为保持简洁，不支持存储之前的聊天记录

由服务和/或客户端进行输入验证

🚨 本仓库使用的许多技术（例如 FastMCP、Anthropic 中的工具调用和 MCP 本身）都非常新，因此这些技术中的一些功能尚不可用或存在 Bug。但主要目标是在不使用 cursor 或 Claude Desktop 的情况下进行简单探索 🚨

符合 MCP 规范的计算器服务

使用 FastMCP 构建，因为它简单且能自动处理错误。 请记住：-

始终将服务命名为 mcp、server 或 app，否则会报错，而且错误信息非常明确

可以添加注释以供将来参考。目前，uv.lock 中对应的 FastMCP 版本尚不支持此功能

MCP 客户端

连接到 MCP 服务，并应能够访问大模型 强烈建议探索和检查模型使用工具时返回的对象，以及通用响应 尝试使用不同格式的数字进行压力测试。 例如：将 Add 2 and 3 与 Add two and three 进行比较。 例如：尝试使用含义模糊且数值较大的数字：将七百万亿与三千亿相加

工作流概览

要重现工作环境，请在 .toml 文件所在位置运行

uv sync

要激活工作环境，请使用

source .venv/bin/activate

要检查服务

进入 fastmcp_calculator_server 文件夹并运行
mcp dev server.py

将你的 Anthropic API 密钥添加到 .env 文件

要运行整个 MCP 应用

进入 mcp_calculator/mcp_compliant_client 并运行
python client.py <path to server.py>

了解更多信息，请参阅 medium.