frontzhm/simple-mcp-server

# 使用 npm 安装
npm install -g pnpm

# 或使用 curl (macOS/Linux)
curl -fsSL https://get.pnpm.io/install.sh | sh -

# 或使用 PowerShell (Windows)
iwr https://get.pnpm.io/install.ps1 -useb | iex

# 验证安装
pnpm --version

# 使用 nvm 管理Node.js版本
# 安装 nvm (如果还没有)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装并使用Node.js 18
nvm install 18
nvm use 18

# 或安装最新LTS版本
nvm install --lts
nvm use --lts

git clone https://github.com/frontzhm/simple-mcp-server.git
cd simple-mcp-server

# 推荐使用 pnpm
pnpm install

# 或使用 npm
npm install

# 启动MCP服务器
pnpm run dev:server

# 或直接运行
node server.js

# 在另一个终端窗口
pnpm run dev

# 在第三个终端窗口
pnpm run test:client

# 或直接运行
node client-example.js

# 启动Next.js开发服务器 (前端)
pnpm run dev

# 启动MCP服务器 (后端)
pnpm run dev:server

# 构建前端
pnpm run build

# 启动生产服务器
pnpm start

PORT=9000 pnpm run dev:server  # MCP服务器端口

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": {
      "name": "my-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {}
    },
    "serverInfo": {
      "name": "simple-mcp-server",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "获取指定城市的天气信息",
        "inputSchema": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "description": "城市名称"
            }
          },
          "required": ["city"]
        }
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {
      "city": "北京"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "北京的天气信息：\n温度: 15°C\n天气: 晴天\n湿度: 45%"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "calculate",
    "arguments": {
      "expression": "2 + 3 * 4"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "计算结果: 2 + 3 * 4 = 14"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_time",
    "arguments": {
      "timezone": "Asia/Shanghai"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "当前时间 (Asia/Shanghai): 2024/1/15 14:30:25"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Tool not found: invalid_tool"
  }
}

initializeTools() {
  return {
    // 现有工具...
    
    // 新工具定义
    my_new_tool: {
      name: "my_new_tool",
      description: "我的新工具描述",
      inputSchema: {
        type: "object",
        properties: {
          param1: {
            type: "string",
            description: "参数1描述"
          },
          param2: {
            type: "number",
            description: "参数2描述"
          }
        },
        required: ["param1"]
      }
    }
  }
}

async handleToolCall(params) {
  const { name, arguments: args } = params

  switch (name) {
    case "get_weather":
      return await this.getWeather(args.city)
    case "calculate":
      return await this.calculate(args.expression)
    case "get_time":
      return await this.getTime(args.timezone)
    // 添加新工具调用
    case "my_new_tool":
      return await this.myNewTool(args.param1, args.param2)
    default:
      throw new Error(`Tool implementation not found: ${name}`)
  }
}

// 工具实现：我的新工具
async myNewTool(param1, param2) {
  try {
    // 工具逻辑实现
    const result = `处理结果: ${param1} - ${param2}`
    
    return {
      content: [
        {
          type: "text",
          text: result
        }
      ]
    }
  } catch (error) {
    throw new Error(`工具执行错误: ${error.message}`)
  }
}

# 启动服务器
pnpm run dev:server

# 在另一个终端测试
pnpm run test:client

import WebSocket from "ws"

class MyMCPClient {
  constructor(url) {
    this.ws = new WebSocket(url)
    // 客户端实现...
  }
  
  async callTool(name, args) {
    return await this.sendRequest("tools/call", {
      name,
      arguments: args
    })
  }
}

// 在 server.js 中添加
console.log("Received message:", JSON.stringify(message, null, 2))

# 测试端口是否开放
telnet localhost 8080

# macOS/Linux (使用Homebrew)
brew install mcp-publisher

# 或下载预构建二进制文件
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/

# Windows PowerShell
$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }
Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"
tar xf mcp-publisher.tar.gz mcp-publisher.exe

mcp-publisher login

mcp-publisher publish

# 更新版本号
pnpm version patch  # 1.0.0 -> 1.0.1
pnpm version minor  # 1.0.0 -> 1.1.0
pnpm version major  # 1.0.0 -> 2.0.0

# 发布新版本
mcp-publisher publish