开发环境

Node.js 20.19.5 或更高版本

下载安装

# 克隆项目
git clone https://gitee.com/tony7/mcp-services.git

# 进入项目目录
cd mcp-services

# 安装依赖
npm install

目录说明

├── 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 示例
├── src ----------------------------- 正式程序文件夹
│   └── index.js -------------------- 主入口文件
└── README.md

依赖说明

{
  "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"对象里添加"计算器"服务器，如下：

// 本地调试
{
    "mcpServers": {
        "calculator": {
            "command": "node",
            "args": ["/<替换为你的文件目录>/MCP_server/src/index.js"] 
        }   
    }
}

// 使用发布版
{
    "mcpServers": {
        "calculator": {
            "command": "npx",
	    "args": ["yeah-tool-box"], 
        }   
    }
}

2.调试

# 普通调试
node src/index.js

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

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

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

MCP客户端示例使用说明

提示：

• 因内部使用了puppeteer，所以在初次加载时安装会相对比较慢，请耐心等待。