# mcp-so-easy

**Repository Path**: nextzero/mcp-so-easy

## Basic Information

- **Project Name**: mcp-so-easy
- **Description**: 超简单的MCP教程示例项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-05-25
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP教程示例项目

>  原生nodejs直接运行、无需typescript配置，适用于初学者和需要快速上手的开发者。

## 开发环境
Node.js 18 或更高版本

## 下载安装

```bash
# 克隆项目
git clone git@gitee.com:changelink/mcp-so-easy.git

# 进入项目目录
cd mcp-so-easy

# 安装依赖
npm install
```

## 目录说明
``` bash

├── server -------------------------- MCP服务端示例
│   ├── server-simple.js ------------ 极简的MCP Server示例
│   ├── server-remote.js ------------ 远程调用示例
│   ├── server-multi-tools.js ------- 多工具示例
├── package.json  
├── client -------------------------- MCP客户端示例
│   ├── function-calling.js --------- 原函数调用示例
│   ├── client.js ------------------- 极简的MCP Client示例
│   ├── client-with-config.js ------- 带配置文件示例
│   ├── mcp_settings.json ----------- 配置文件
│   └── client-no-sdk.js ------------ 无配 MCP SDK 示例
└── README.md
```

## 依赖说明
```json
{
  "type": "module",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.4", // MCP 官方 SDK（本项目主要用于MCP客户端的实现）
    "fastmcp": "^3.1.1", // fastmcp 是基于MCP 官方 SDK 构建的快速开发MCP服务端的库 （本项目主要用于MCP服务端的实现）
    "openai": "^4.104.0", // OpenAI API 库（本项目主要用于MCP客户端LLM接口的调用）
    "zod": "^3.25.64" // Zod 库（本项目主要用于MCP服务端工具函数的参数校验）
  }
}
```

## MCP服务端示例使用说明
### 1.MCP服务器配置
在客户端（vscode的cline插件）的MCP服务器配置文件中的"mcpServers"对象里添加"计算器"服务器，如下： 
```json
{
    mcpServers: {
        "calculator": {
            "command": "node",
            "args": ["/<替换为你的文件目录>/mcp-so-easy/server/server-simple.js"]
        }   
    }
}
```
Windows 用户请将"args"中的"/"替换为"\\\\"

### 2.调试

```bash
# 普通调试
node server/server-simple.js

# 使用 MCP Inspector 工具调试
npx @modelcontextprotocol/inspector node server/server-simple.js --stdio

# 点击访问上述命令行中的提示中如下形式的链接：
http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=1aa8424afc42f7ab88ab3fef85f26924e2359bbce5a849ba1a36a3196ab944bb

# Windows 用户如运行报错，请将 server/server-simple.js 中的"/"替换为"\"
```


## MCP客户端示例使用说明
### 1.API配置
`client-simple.js`文件中的API配置(其他client示例文件需要做同样配置才能运行)，替换为你的API Key和Base URL，如下：
```js
const client = new OpenAI({
  apiKey: "<替换为你的API Key>",
  baseURL: "https://api.siliconflow.cn/v1"
});
```

`硅基流动`新注册用户送14元，注册地址：[https://cloud.siliconflow.cn/i/x63lRCBM](https://cloud.siliconflow.cn/i/x63lRCBM)（请使用这个地址注册，这样我就成为了你的邀请人，我会得到一定的邀请激励，谢谢！）。API Key位置如下：
![1750679388172.png](https://cdn.bigbug.net/2025/06/23/68593f5eb7a90.png)
**tips:** 本项目示例用得是硅基流动的API，如需使用其他API，可自行替换。


### 2.运行

```bash
# 极简的MCP Client示例运行
node client/client-simple.js

# 其他示例运行 
node client/<这里替换为你需运行的示例文件>

# Windows 用户如运行报错，请将命令中的"/"替换为"\"
```


作者公众号：[大虫小呓](https://cdn.bigbug.net/2025/06/18/6852b18a2b36e.jpg)

![大虫小呓](https://cdn.bigbug.net/2025/06/18/6852b18a2b36e.jpg) 

有问必答，欢迎关注！