使用说明(Markdown格式)

  • 项目简介
    • Workstation MCP Server 是一个面向 LLM 客户端的后端服务,按照 Model Context Protocol (MCP) 规范实现,提供资源托管、工具注册与执行、以及提示模板的定义/渲染,确保 LLM 或 AI 代理可以通过统一的协议获取所需上下文与能力,并支持实时通信。
  • 主要功能点
    • MCP 协议实现与 JSON-RPC 风格的请求/响应处理
    • 资源(Resources)的注册、查询与访问,便于后端向 LLM 客户端提供数据
    • 工具(Tools)的注册、执行与结果返回,支持 LLM 调用外部功能
    • 提示模板(Prompts)的管理与渲染,支持自定义交互模式
    • MCP WebSocket 实时通信,支持浏览器扩展、代理与多客户端并发
    • 会话管理、权限控制、JWT 认证、速率限制等安全能力
    • 与 Chrome Extension 等客户端的集成,提供端到端的 MCP 服务生态
  • 安装步骤
      1. 将仓库克隆到本地
      1. 安装依赖并构建:npm install;npm run build
      1. 启动服务器:npm start
      1. 后续可使用 MCP 客户端(如 Copilot/AI Agent)进行接入,端口默认 3000,MCP 服务地址如 http://localhost:3000
  • 服务器配置(MCP 客户端需要的连接信息,示例为 JSON 配置,描述仅供参考,不是代码)
    • {
    • "serverName": "workstation-mcp-server",
    • "command": "node",
    • "args": ["dist/index.js"],
    • "port": 3000,
    • "description": "Workstation MCP Server",
    • "auth": {
    • "type": "bearer",
    • "tokenUrl": "http://localhost:3000/auth/demo-token"
    • },
    • "transports": ["http", "ws", "stdio"],
    • "mcpVersion": "1.0.0",
    • "notes": "MCP 客户端通过该配置可连接服务器并使用资源、工具与 Prompts 提供的能力"
    • }
    • 注释:
      • serverName:服务器对外的唯一标识
      • command/args:启动服务器的命令及参数
      • port:服务器监听端口
      • transports:支持的传输协议集合(如 http/WS/stdio)
      • auth:认证方式与获取令牌的端点信息(如需要令牌才能访问 MCP 服务)
      • mcpVersion:MCP 版本标识
  • 基本使用方法
    • 启动后,服务器对外开放 MCP 接口,客户端可通过指定的 JSON-RPC 风格请求向服务器读取资源、调用工具、获取 Prompts,并接收响应或通知。
    • 客户端可以订阅 MCP WebSocket 通道,获取实时事件与状态更新,按需渲染 UI、执行任务或触发工具执行。
    • 开发者可在服务器端添加自定义资源、工具、Prompts 以及新的 MCP 容器/微服务,以扩展能力。

信息

分类

开发者工具