MCP Demo Server
一个基于 Model Context Protocol (MCP) 的演示服务器,展示如何构建可与 AI 助手集成的自定义工具集。
🚀 项目简介
Model Context Protocol (MCP) 是一个标准化协议,用于 AI 助手与外部工具和数据源的安全连接。本项目实现了一个功能完整的 MCP 服务器,提供数学计算和多语言问候功能,可无缝集成到支持 MCP 的 AI 客户端中(如 Claude Desktop、Cursor 等)。
✨ 功能特性
🔧 内置工具
- 🧮 add - 两数相加计算器
- 👋 greet - 多语言智能问候生成器(支持英语、中文、西班牙语、法语)
- 📊 calculate - 高级数学运算工具(加减乘除,含错误处理)
🏗️ 技术特点
- ✅ 基于最新 MCP SDK 构建
- ✅ TypeScript 类型安全
- ✅ JSON Schema 参数验证
- ✅ 完整错误处理机制
- ✅ stdio 通信协议
- ✅ 生产就绪的代码结构
📦 安装配置
环境要求
- Node.js 18+
- npm 或 yarn
- TypeScript 支持
快速开始
项目结构
demo/ ├── demo.ts # MCP 服务器主文件 ├── package.json # 项目配置 ├── test-advanced.js # 高级功能测试脚本 └── README.md # 项目文档
🔧 使用方法
在 Cursor 中配置
- 打开 Cursor 配置文件:
~/.config/cursor/claude_desktop_config.json
- 添加 MCP 服务器配置:
- 重启 Cursor
在 Claude Desktop 中配置
示例使用:
💡 如何触发 MCP 工具调用
明确要求使用工具
使用 MCP 工具计算 100 + 200
调用你的数学工具计算这个
用外部计算器算一下
复杂一些的任务
计算 π × 2.5 的平方根
用多种语言问候客户
批量计算这些数字
明确的工具名称
用 add 工具计算
使用 calculate 功能
调用 greet 工具
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A demonstration server based on Model Context Protocol (MCP) that showcases how to build custom tools for AI assistants, providing mathematical calculation and multilingual greeting capabilities.
Related MCP Servers
- AsecurityAlicenseAqualityThis server provides a minimal template for creating AI assistant tools using the ModelContextProtocol, featuring a simple 'hello world' tool example and development setups for building custom MCP tools.Last updated -167610TypeScriptThe Unlicense
- AsecurityAlicenseAqualityA foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.Last updated -126TypeScriptMIT License
- -securityFlicense-qualityA simple demonstration project for the Model Control Protocol (MCP) server that provides tools for AI assistants to fetch news articles, perform calculations, retrieve weather data, and generate personalized greetings.Last updated -Python
- -securityAlicense-qualityA guide for implementing Model Context Protocol (MCP) servers that provide AI models with external tools like web search, text manipulation, and mathematical operations.Last updated -8PythonMIT License