Skip to main content
Glama

MCP Demo Server

by joeguo911
GitHub
TypeScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

快速开始

# 克隆项目 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 服务器配置：
{ "mcpServers": { "demo-server": { "command": "npx", "args": ["tsx", "/path/to/your/demo/demo.ts"], "cwd": "/path/to/your/demo" } } }
  1. 重启 Cursor

在 Claude Desktop 中配置

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

示例使用：

💡 如何触发 MCP 工具调用

明确要求使用工具

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

复杂一些的任务

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

明确的工具名称

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

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

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.

  1. 🚀 项目简介
    1. ✨ 功能特性
      1. 🔧 内置工具
      2. 🏗️ 技术特点
    2. 📦 安装配置
      1. 环境要求
      2. 快速开始
      3. 项目结构
    3. 🔧 使用方法
      1. 在 Cursor 中配置
      2. 在 Claude Desktop 中配置
      3. 💡 如何触发 MCP 工具调用

    Related MCP Servers

    • MCP Starter Server

      MatthewDailey
      A
      security
      A
      license
      A
      quality
      This 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 -
      1
      431
      11
      The Unlicense
      • Apple

    • MCP Starter

      instructa
      A
      security
      A
      license
      A
      quality
      A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
      Last updated -
      1
      28
      MIT License

    • MCP Server Demo

      dynstat
      A
      security
      F
      license
      A
      quality
      A 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 -
      3

    • MCP Guide

      switchblxdee
      -
      security
      A
      license
      -
      quality
      A 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 -
      8
      MIT License

    View all related MCP servers

    New MCP Servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/joeguo911/mcp-demo'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server