# 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 支持

### 快速开始

```bash
# 克隆项目
git clone <repository-url>
cd mcp-demo-server/demo

# 安装依赖
npm install

# 启动服务器
npm start
```

### 项目结构

demo/
├── demo.ts # MCP 服务器主文件
├── package.json # 项目配置
├── test-advanced.js # 高级功能测试脚本
└── README.md # 项目文档

## 🔧 使用方法

### 在 Cursor 中配置

1. 打开 Cursor 配置文件：`~/.config/cursor/claude_desktop_config.json`

2. 添加 MCP 服务器配置：

```json
{
  "mcpServers": {
    "demo-server": {
      "command": "npx",
      "args": ["tsx", "/path/to/your/demo/demo.ts"],
      "cwd": "/path/to/your/demo"
    }
  }
}
```

3. 重启 Cursor

### 在 Claude Desktop 中配置

```json
{
  "mcpServers": {
    "demo-server": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/your/demo"
    }
  }
}
```

**示例使用：**

### 💡 如何触发 MCP 工具调用

#### 明确要求使用工具

使用 MCP 工具计算 100 + 200\
调用你的数学工具计算这个\
用外部计算器算一下

#### 复杂一些的任务

计算 π × 2.5 的平方根\
用多种语言问候客户\
批量计算这些数字

#### 明确的工具名称

用 add 工具计算\
使用 calculate 功能\
调用 greet 工具