MCP Course Code

MCP课程代码

此存储库包含多个MCP（模型上下文协议）服务器示例和一个客户端测试工具。每个项目都展示了构建和使用MCP服务器的不同方面。

项目概述

1. 示例1-MCP：Math MCP服务器-提供基本的数学运算和数学笑话
2. 示例3-Priv Esc：待办事项列表MCP服务器-管理用户（Alice和Bob）的待办事项列表
3. Ex4-选择服务器：天气MCP服务器-返回与天气相关的笑话
4. mcp-lite：MCP客户端测试器-用于测试和与MCP服务器交互的工具

先决条件

• Node.js >= 18.0.0
• npm >= 9.0.0

要检查您的版本，请执行以下操作：

node --version
npm --version

安装

每个项目都有自己的依赖关系。导航到每个项目目录并安装依赖项：

Ex1-MCP（数学服务器）

cd "Ex1 - MCP"
npm install

Ex3-Priv Esc（待办事项列表服务器）

cd "Ex3 - Priv Esc"
npm install

Ex4-选择服务器（天气服务器）

cd "Ex4 - Select server"
npm install

mcp-lite（mcp客户端测试仪）

cd mcp-lite
npm install

可选-全局安装：

cd mcp-lite
npm install -g

这使得 mcp-client 全球可用的命令。

用法

示例1-MCP：数学服务器

提供数学运算和数学笑话的服务器。

运行服务器

cd "Ex1 - MCP"
npm start

或者直接：

node src/index.js

可用工具

• 添加：添加两个数字({ "a": 5, "b": 3 })
• 减去：减去两个数字({ "a": 10, "b": 4 })
• 乘：将两个数字相乘({ "a": 7, "b": 6 })
• 划分：除以两个数字({ "a": 20, "b": 4 })
• 力量：将数字提高到幂({ "base": 2, "exponent": 8 })
• get_math_job：看一个随机的数学笑话({})

Claude桌面配置

添加到您的Claude Desktop配置文件(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "math-server": {
      "command": "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex1 - MCP/run-server.sh"
    }
  }
}

备注：更新路径以匹配您的实际项目位置。确保 run-server.sh 可执行：

chmod +x "Ex1 - MCP/run-server.sh"

Ex3-Priv Esc：待办事项列表服务器

为用户（Alice和Bob）管理待办事项列表的服务器。

运行服务器

cd "Ex3 - Priv Esc"
npm start

或者直接：

node src/index.js

可用工具

• get_所有：获取用户的所有待办事项

  { "email": "alice@example.com" }

• create_todo：为用户创建新的待办事项

  {
    "email": "bob@example.com",
    "title": "Review pull request #123",
    "priority": "high",
    "status": "pending"
  }

• 标记全部完成：将待办事项标记为已完成

  {
    "email": "alice@example.com",
    "todo_id": 1
  }

Claude桌面配置

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "todo-list-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex3 - Priv Esc/src/index.js"
      ]
    }
  }
}

备注：更新路径以匹配您的实际项目位置。

Ex4-选择服务器：天气服务器

返回与天气相关的笑话（带有幽默转折）的服务器。

运行服务器

cd "Ex4 - Select server"
npm start

或者直接：

node src/index.js

可用工具

• 预测：获取天气预报（实际上返回一个与天气有关的笑话）

  {}

Claude桌面配置

添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "weather-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex4 - Select server/src/index.js"
      ]
    }
  }
}

备注：更新路径以匹配您的实际项目位置。

mcp-lite:mcp客户端测试仪

用于测试和与MCP服务器交互的命令行工具。可用于安全测试、工具枚举和服务器配置分析。

配置

创建一个 MCPserver.json 文件在 mcp-lite 目录（或指定一个自定义路径 --config):

{
  "mcpServers": {
    "math-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex1 - MCP/src/index.js"
      ]
    },
    "todo-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex3 - Priv Esc/src/index.js"
      ]
    },
    "weather-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex4 - Select server/src/index.js"
      ]
    }
  }
}

备注：更新所有路径以匹配您的实际项目位置。

常用命令

列出所有服务器上的所有工具：

cd mcp-lite
npm start -- list
# or if installed globally:
mcp-client list

列出特定服务器上的工具：

npm start -- list --server math-server
# or
mcp-client list --server math-server

列出所有已配置的服务器：

npm start -- servers
# or
mcp-client servers

获取服务器信息：

npm start -- info math-server
# or
mcp-client info math-server

生成工具调用模板：

npm start -- generate math-server add
# or
mcp-client generate math-server add

调用工具：

npm start -- call math-server add --args '{"a":5,"b":3}'
# or
mcp-client call math-server add --args '{"a":5,"b":3}'

使用文件中的参数调用工具：

npm start -- call math-server add --args-file ./args.json
# or
mcp-client call math-server add --args-file ./args.json

JSON输出（用于自动化）：

npm start -- list --json
# or
mcp-client list --json

自定义配置文件：

npm start -- list --config /path/to/config.json
# or
mcp-client list --config /path/to/config.json

有关更详细的使用信息，请参阅 mcp-lite自述文件.

Claude桌面配置

要在Claude Desktop中使用多个服务器，请将所有服务器配置合并到一个服务器中 mcpServers 对象：

macOS位置: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows位置: %APPDATA%\Claude\claude_desktop_config.json

组合配置示例：

{
  "mcpServers": {
    "math-server": {
      "command": "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex1 - MCP/run-server.sh"
    },
    "todo-list-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex3 - Priv Esc/src/index.js"
      ]
    },
    "weather-server": {
      "command": "node",
      "args": [
        "/Users/katiepaxtonfear/Documents/MCP Course Code/Ex4 - Select server/src/index.js"
      ]
    }
  }
}

重要提示：

• 更新所有路径以匹配您的实际项目位置
• 找到你的Node.js路径 which node （macOS/Linux）或 where node （Windows）
• 确保 run-server.sh 可执行： chmod +x "Ex1 - MCP/run-server.sh"
• 更新配置后，重新启动Claude Desktop

故障排除

服务器无法启动

1. 检查Node.js安装：

   which node  # macOS/Linux
   where node  # Windows

1. 验证是否安装了依赖项：

   cd 

   npm install

1. 手动测试服务器：

   cd 

   npm start

1. 检查文件权限 （对于shell脚本）：

   chmod +x "Ex1 - MCP/run-server.sh"

Claude桌面问题

1. 检查克劳德桌面日志 用于错误消息
2. 验证路径 配置文件中的信息是正确和绝对的
3. 重新启动克劳德桌面 进行配置更改后
4. 手动测试服务器 首先，确保他们独立工作

mcp-lite连接问题

1. 验证服务器配置 在 MCPserver.json
2. 检查服务器命令是否可用 在你的路径中
3. 确保所需的环境变量 已设置（如果有）
4. 单独测试服务器 使用 npm start 在每个项目目录中

项目结构

MCP Course Code/
├── Ex1 - MCP/              # Math MCP Server
│   ├── src/
│   │   └── index.js
│   ├── package.json
│   ├── run-server.sh
│   └── claude_desktop_config.json
├── Ex3 - Priv Esc/         # Todo List MCP Server
│   ├── src/
│   │   └── index.js
│   ├── package.json
│   └── claude_desktop_config.json
├── Ex4 - Select server/    # Weather MCP Server
│   ├── src/
│   │   └── index.js
│   ├── package.json
│   └── claude_desktop_config.json
└── mcp-lite/              # MCP Client Tester
    ├── src/
    │   ├── cli.js
    │   ├── mcp-client.js
    │   └── oauth-provider.js
    ├── package.json
    └── MCPserver.json.example

额外资源

• 每个项目都有自己的详细README，其中包含具体的使用说明
• 有关更多示例和详细文档，请参阅单个项目的自述文件
• MCP文件

许可证

此存储库中的所有项目都在MIT下获得许可。