使用说明（Markdown 格式）

该仓库实现了一个 MCP 服务器，用于向支持 MCP 的 LLM 客户端（如 Claude Code、Cursor、Windsurf 等）暴露统一的工具集合、模型查询以及简单的生产化能力（如图片生成、语音合成、余额查询等）。
服务器通过 JSON-RPC 规范与客户端通信，注册并执行工具、获取模型列表、执行任务等。

MCP 服务器核心功能
- 注册并暴露工具集合（如 chat、list_models、generate_image、text_to_speech、get_balance、recommend_model 等）。
- 处理调用请求，执行对应的工具实现逻辑，返回 JSON 化结果。
- 支持通过 stdio 传输与 MCP 客户端建立连接，具备会话与能力声明能力。
工具实现与能力
- chat：在 SkillBoss 联合 API 下对接多模型对话能力。
- list_models：列出可用模型及其描述。
- generate_image/text_to_speech/get_balance/recommend_model 等工具，提供基础的数据访问与任务建议。
服务器实现细节
- 使用 @modelcontextprotocol/sdk 的 Server 与 StdioServerTransport 搭建 MCP 服务。
- 通过 ListToolsRequestSchema、CallToolRequestSchema 实现工具枚举与调用的请求/响应处理。
- 依赖 SkillBoss API，需配置 SKILLBOSS_API_KEY，BASE_URL 默认为 https://api.heybossai.com/v1。

先确保 Node.js 环境就绪
安装并启动 MCP 服务器（示例最常用方式）
- npx @skillboss/mcp-server
- 或在本地安装后全局执行 skillboss-mcp
环境变量
- SKILLBOSS_API_KEY：你的 SkillBoss API Key
- SKILLBOSS_BASE_URL（可选）：SkillBoss API 基础地址，默认为 https://api.heybossai.com/v1

MCP 客户端连接配置（示例，按你的 MCP 客户端配置要求填写）配置信息为 JSON 格式，包含 server name、command、args 等参数（MCP 客户端不需要修改服务器端代码，只需要在客户端配置连接到该 MCP 服务器）。 { "server": "skillboss", "command": "npx", "args": ["-y", "@skillboss/mcp-server"], "env": { "SKILLBOSS_API_KEY": "sk-your-key" } /* 注释说明：
- server: 服务器标识名，应与服务器在代码中注册的名称一致（此处为 "skillboss"）。
- command / args: 启动服务器的命令及参数。常用为 npx @skillboss/mcp-server。
- env: 环境变量，至少需要 SKILLBOSS_API_KEY，有时也可设置 SKILLBOSS_BASE_URL。 */ }
基本使用方法

启动服务器后，MCP 客户端即可通过 JSON-RPC 调用服务器暴露的工具，如 chat、list_models、generate_image、text_to_speech 等。
典型工作流示例（简述）
- 请求模型列表：调用 list_models 工具获取支持模型清单及描述。
- 发起对话：使用 chat 工具，提供 model、message、system、max_tokens、temperature 等参数，获取模型回复与 token 使用信息。
- 生成资源：调用 generate_image 获取图片 URL，与后续的下载和渲染结合使用。
- 询问余额或推荐模型等辅助能力以优化任务成本与性能。

该 MCP 服务器实现可扩展新的工具，只需在 tools 数组中注册新的 tool 描述和输入/输出 schema，并在 CallToolRequestSchema 的分支中实现对应处理函数即可。
环境变量与 API Key 的管理应在部署时通过安全渠道配置，避免暴露凭据。

SkillBoss MCP 服务器（Model Context Protocol 实现）