JobTread Tools Pro MCP 服务器
使用说明
- 项目简介
- 该仓库实现了一个 MCP 服务器框架,能够托管 Resources、注册并执行 Tools,以及定义与渲染 Prompts,提供统一的 JSON-RPC、SSE 和 HTTP 转换层,与 LLM 客户端建立安全、可扩展的上下文服务。
- 服务器支持对接多种 AI 客户端(Claude、ChatGPT、Gemini、Cursor 等),并提供能力声明、会话管理、以及基于工具的可扩展调用能力。
- 主要功能点
- MCP 服务端核心
- 支持 JSON-RPC 请求处理(initialize、tools/list、tools/call、resources/list、resources/read、prompts/list、prompts/get、ping 等)
- 提供 SSE 和 HTTP 两种传输模式,便于不同类型的客户端接入
- 工具与知识服务
- JobTreadTools:定义并实现对 JobTread 相关操作的工具集合(如搜索/获取任务、预算、联系人等)
- KnowledgeLookup:知识检索工具,联合用户 SOP 与官方文档结果,并可与 Palette 进行组合输出
- 资源与 Prompts
- 支持资源的列出与读取,以及提示模板的列表与获取(Prompts)
- 授权与版本
- 结合授权与 tier 系统,按权限暴露 MCP 能力(包含 MCP 访问、AI 知识查询等能力)
- MCP 服务端核心
- 安装与运行方式
- 该仓库提供两种部署方式:
- Cloudflare Worker 部署(推荐,使用 worker 端点对外提供 MCP 服务)
- 本地/自建服务器实现(Express/Node 端口部署的代理与服务端能力)
- 端点说明
- SSE 传输端点:/sse
- HTTP 请求端点:/message
- 健康检查:/health(服务器健康信息)
- 其他调试端点:/tools(工具列表)
- 部署要点
- 需将 MCP 服务端代码配置为可对外暴露的端点,确保授权、CORS、速率限制等安全策略正确配置
- 客户端需要的鉴权格式为 Bearer <license_key>:<grant_key>
- 该仓库提供两种部署方式:
- 服务器配置(MCP 客户端启动信息说明) 以下信息用于 MCP 客户端配置,描述服务器名称、启动命令及参数。请注意,实际部署以你选择的运行环境为准(Cloudflare Worker 直接在线执行,无需本地启动命令),下列配置仅用于帮助理解连接参数。 { "server": { "name": "JobTread Tools Pro MCP Server (Cloudflare Worker)", "command": "cloudflare-wrangler", "args": [ "publish", "--name", "jobtread-tools-pro-mcp", "--url", "https://jobtread-tools-pro.king0lightai.workers.dev" ], "endpoints": { "sse": "https://jobtread-tools-pro.king0lightai.workers.dev/sse", "message": "https://jobtread-tools-pro.king0lightai.workers.dev/message", "health": "https://jobtread-tools-pro.king0lightai.workers.dev/health" } }, "notes": "MCP 客户端通过 Bearer <license_key>:<grant_key> 进行鉴权,连接到上述 SSE/HTTP 端点以进行工具调用、资源获取等操作。云端部署的端点无需额外运行命令,客户端仅需要连接信息与鉴权参数。" }
- 基本使用方法
- 部署与启动
- 使用 Cloudflare Worker 部署:将服务器代码部署到 Cloudflare,获取工作 URL(示例:https://jobtread-tools-pro.king0lightai.workers.dev)。
- 如选择本地/自建服务器,请参照仓库提供的 Express/Proxy 方案进行搭建,并确保暴露 /sse 与 /message 路径。
- 连接与鉴权
- MCP 客户端需使用 Bearer 格式的鉴权:Bearer <license_key>:<grant_key>
- 将连接端点配置为上述 SSE/HTTP 端点之一,客户端可通过这些端点发起 MCP JSON-RPC 请求或订阅事件流
- 使用示例
- 通过 JSON-RPC 调用工具列表:发送 initialize/tools/list 请求
- 调用某个工具:发送 tools/call 请求,携带工具名称及参数
- 资源、Prompts 的读取与渲染按 MCP 规范处理,服务端将返回相应的 JSON-RPC 响应
- 运行与调试
- 登录 Cloudflare 控制台并部署 Worker,或在本地/自建服务器上启动 Express/代理服务
- 使用浏览器/Postman/自定义客户端进行测试,请留意 CORS、速率限制、以及许可状态
- 部署与启动