From 11548e854e6f44fa3e2fecde3bc223f89550aa9b Mon Sep 17 00:00:00 2001 From: zyc123 <2594064239@qq.com> Date: Thu, 14 May 2026 18:02:52 +0800 Subject: [PATCH] 456 --- skills/oneinai-aimcp.md | 283 ++++++++++++++++++---------------------- 1 file changed, 128 insertions(+), 155 deletions(-) diff --git a/skills/oneinai-aimcp.md b/skills/oneinai-aimcp.md index c1cc2ce..ba921c1 100644 --- a/skills/oneinai-aimcp.md +++ b/skills/oneinai-aimcp.md @@ -1,202 +1,175 @@ -# ikuncode-aimcp - 统一 AI MCP 服务器 +# oneinai-aimcp - 统一 AI MCP 服务器 **一个二进制，三套 AI 引擎 — Gemini · Codex · Grok** -📋 简介 +## 📋 简介 -ikuncode-aimcp 是一个用 Rust 编写的统一 MCP 服务器，将 Gemini CLI、Codex CLI 和 Grok Search 整合到单个进程中。配置一次，即可在 Cursor / Windsurf / Claude Desktop 等任意 MCP 客户端中使用全部工具。 +oneinai-aimcp 是一个用 Rust 编写的统一 MCP 服务器，将 Gemini CLI、Codex CLI 和 Grok Search 整合到单个进程中。配置一次，即可在 Cursor / Windsurf / Claude Desktop 等任意 MCP 客户端中使用全部工具。 -## 🔗 相关链接 +## 🔗 相关链接 -资源| 地址 ----|--- -GitHub 仓库| [xuxu777xu/ikuncode-aimcp]() -ikun API| [api.ikuncode.cc]() - -## ✨ 功能特点 +| 资源 | 地址 | +| --- | --- | +| GitHub 仓库 | [xuxu777xu/oneinai-aimcp](https://github.com/xuxu777xu/oneinai-aimcp) | +| oneinai API | | +| oneinai 控制台 | | - * ✅ **一个二进制，全部工具** ：只需配置一个 MCP 服务器，取代三个独立安装 - * ✅ **运行时检测** ：启动时自动检测可用工具，不可用的工具返回清晰错误信息 - * ✅ **AdaptiveStdio 传输** ：自动检测 JSONL 和 LSP 帧格式，最大化客户端兼容性 - * ✅ **纯 Rust GrokSearch** ：零 Python 依赖，通过 Grok API 实现 Web 搜索和内容抓取 - * ✅ **Gemini 图像生成** ：内置 `gemini_image` 工具，支持宽高比和分辨率控制 +## ✨ 功能特点 -## 🧰 工具列表 +- ✅ **一个二进制，全部工具**：只需配置一个 MCP 服务器，取代三个独立安装 +- ✅ **运行时检测**：启动时自动检测可用工具，不可用的工具返回清晰错误信息 +- ✅ **AdaptiveStdio 传输**：自动检测 JSONL 和 LSP 帧格式，最大化客户端兼容性 +- ✅ **纯 Rust GrokSearch**：零 Python 依赖，通过 Grok API 实现 Web 搜索和内容抓取 +- ✅ **Gemini 图像生成**：内置 `gemini_image` 工具，支持宽高比和分辨率控制 -工具| 来源| 描述 ----|---|--- -`gemini`| Gemini CLI| AI 驱动的任务执行，支持会话连续性 -`gemini_image`| Gemini CLI| AI 图像生成，使用专用生图模型 -`codex`| Codex CLI| AI 辅助编码，支持沙箱策略 -`web_search`| Grok API| Web 搜索，返回结构化 JSON 结果 -`web_fetch`| Grok API| 抓取网页内容并转为 Markdown -`get_config_info`| Grok API| 显示配置信息并测试 API 连接 - -### 相关项目 +## 🧰 工具列表 -项目| 类型| 适用场景 ----|---|--- -**ikuncode-aimcp** （本项目）| MCP Server| 所有 MCP 客户端通用，含 gemini_image 图像生成 -[ikunimage]()| Claude Code Skill| Claude Code 专用 — 文生图 / 图生图 / 并发批量生成 - -## 🛠️ 安装 +| 工具 | 来源 | 描述 | +| --- | --- | --- | +| `gemini` | Gemini CLI | AI 驱动的任务执行，支持会话连续性 | +| `gemini_image` | Gemini CLI | AI 图像生成，使用专用生图模型 | +| `codex` | Codex CLI | AI 辅助编码，支持沙箱策略 | +| `web_search` | Grok API | Web 搜索，返回结构化 JSON 结果 | +| `web_fetch` | Grok API | 抓取网页内容并转为 Markdown | +| `get_config_info` | Grok API | 显示配置信息并测试 API 连接 | -### 方式一：下载预编译二进制（推荐） +### 相关项目 -从 [GitHub Releases]() 下载对应平台的二进制文件： +| 项目 | 类型 | 适用场景 | +| --- | --- | --- | +| **oneinai-aimcp**（本项目） | MCP Server | 所有 MCP 客户端通用，含 gemini_image 图像生成 | +| [oneimage](/skills/oneimage) | Claude Code Skill | Claude Code 专用 — 文生图 / 图生图 / 并发批量生成 | + +## 🛠️ 安装 + +### 方式一：下载预编译二进制（推荐） + +从 [GitHub Releases](https://github.com/xuxu777xu/oneinai-aimcp/releases) 下载对应平台的二进制文件： + +| 平台 | 文件名 | +| --- | --- | +| Windows x64 | `oneinai-aimcp-x86_64-pc-windows-msvc.exe` | +| macOS Apple Silicon | `oneinai-aimcp-aarch64-apple-darwin` | +| macOS Intel | `oneinai-aimcp-x86_64-apple-darwin` | +| Linux x64 | `oneinai-aimcp-x86_64-unknown-linux-gnu` | -平台| 文件名 ----|--- -Windows x64| `ikuncode-aimcp-x86_64-pc-windows-msvc.exe` -macOS Apple Silicon| `ikuncode-aimcp-aarch64-apple-darwin` -macOS Intel| `ikuncode-aimcp-x86_64-apple-darwin` -Linux x64| `ikuncode-aimcp-x86_64-unknown-linux-gnu` - 下载后放到 `PATH` 目录中即可使用。macOS / Linux 需要添加执行权限： -bash - - - chmod +x ikuncode-aimcp-* - mv ikuncode-aimcp-* /usr/local/bin/ikuncode-aimcp +```bash +chmod +x oneinai-aimcp-* +mv oneinai-aimcp-* /usr/local/bin/oneinai-aimcp +``` -1 -2 +### 方式二：npm 安装 -### 方式二：npm 安装 +```bash +npm install -g oneinai-aimcp +``` -bash - - - npm install -g ikuncode-aimcp +### 方式三：cargo 安装 -1 +```bash +cargo install --git https://github.com/xuxu777xu/oneinai-aimcp.git +``` -### 方式三：cargo 安装 +### 方式四：从源码编译 -bash - - - cargo install --git https://github.com/xuxu777xu/ikuncode-aimcp.git +```bash +git clone https://github.com/xuxu777xu/oneinai-aimcp.git +cd oneinai-aimcp +cargo build --release +# 二进制文件在 target/release/ 目录下 +``` -1 +## ⚙️ 配置 MCP 客户端 -### 方式四：从源码编译 +在你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）中添加以下配置： -bash - - - git clone https://github.com/xuxu777xu/ikuncode-aimcp.git - cd ikuncode-aimcp - cargo build --release - # 二进制文件在 target/release/ 目录下 - -1 -2 -3 -4 - -## ⚙️ 配置 MCP 客户端 - -在你的 MCP 客户端（如 Claude Desktop、Cursor、Windsurf 等）中添加以下配置： - -json - - - { - "mcpServers": { - "ikuncode-aimcp": { - "command": "ikuncode-aimcp", - "env": { - "GEMINI_API_KEY": "你的-gemini-api-key", - "GROK_API_KEY": "你的-grok-api-key" - } - } +```json +{ + "mcpServers": { + "oneinai-aimcp": { + "command": "oneinai-aimcp", + "env": { + "GEMINI_API_KEY": "你的-gemini-api-key", + "GROK_API_KEY": "你的-grok-api-key" } } + } +} +``` -1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 +> ⚠️ **环境变量说明** +> - `GEMINI_API_KEY`：用于 Gemini 相关工具（`gemini`、`gemini_image`） +> - `GROK_API_KEY`：用于 Grok 搜索工具（`web_search`、`web_fetch`） +> - Codex 工具使用独立配置，请参考 [Codex 部署文档](/deploy/codex) -⚠️ 环境变量说明 +## 📖 工具使用说明 - * `GEMINI_API_KEY`：用于 Gemini 相关工具（`gemini`、`gemini_image`） - * `GROK_API_KEY`：用于 Grok 搜索工具（`web_search`、`web_fetch`） - * Codex 工具使用独立配置，请参考 [Codex 部署文档]() +### `gemini` — AI 任务执行 -## 📖 工具使用说明 +| 参数 | 必填 | 类型 | 默认值 | 描述 | +| --- | --- | --- | --- | --- | +| `PROMPT` | 是 | string | — | 发送给 Gemini 的任务指令 | +| `sandbox` | 否 | bool | `false` | 在沙箱模式下运行 | +| `SESSION_ID` | 否 | string | — | 恢复已有会话，用于多轮对话 | +| `model` | 否 | string | — | 模型覆盖 | +| `timeout_secs` | 否 | int | `600` | 超时时间（1–3600 秒） | -### gemini — AI 任务执行 +### `gemini_image` — 图像生成 -参数| 必填| 类型| 默认值| 描述 ----|---|---|---|--- -`PROMPT`| 是| string| —| 发送给 Gemini 的任务指令 -`sandbox`| 否| bool| false| 在沙箱模式下运行 -`SESSION_ID`| 否| string| —| 恢复已有会话，用于多轮对话 -`model`| 否| string| —| 模型覆盖 -`timeout_secs`| 否| int| 600| 超时时间（1–3600 秒） - -### gemini_image — 图像生成 +| 参数 | 必填 | 类型 | 默认值 | 描述 | +| --- | --- | --- | --- | --- | +| `PROMPT` | 是 | string | — | 图像生成指令 | +| `model` | 否 | string | — | 模型覆盖 | +| `output_dir` | 否 | string | — | 图片保存目录 | +| `aspect_ratio` | 否 | string | — | 宽高比（1:1 / 16:9 / 9:16 等） | +| `image_size` | 否 | string | — | 分辨率（1K / 2K / 4K） | +| `timeout_secs` | 否 | int | `600` | 超时时间（1–3600 秒） | -参数| 必填| 类型| 默认值| 描述 ----|---|---|---|--- -`PROMPT`| 是| string| —| 图像生成指令 -`model`| 否| string| —| 模型覆盖 -`output_dir`| 否| string| —| 图片保存目录 -`aspect_ratio`| 否| string| —| 宽高比（1:1 / 16:9 / 9:16 等） -`image_size`| 否| string| —| 分辨率（1K / 2K / 4K） -`timeout_secs`| 否| int| 600| 超时时间（1–3600 秒） - -### codex — AI 辅助编码 +### `codex` — AI 辅助编码 -参数| 必填| 类型| 默认值| 描述 ----|---|---|---|--- -`PROMPT`| 是| string| —| 发送给 Codex 的任务指令 -`cd`| 是| string| —| 工作目录路径 -`sandbox`| 否| string| `read-only`| 沙箱策略 - -### web_search — Web 搜索 +| 参数 | 必填 | 类型 | 默认值 | 描述 | +| --- | --- | --- | --- | --- | +| `PROMPT` | 是 | string | — | 发送给 Codex 的任务指令 | +| `cd` | 是 | string | — | 工作目录路径 | +| `sandbox` | 否 | string | `read-only` | 沙箱策略 | -参数| 必填| 类型| 默认值| 描述 ----|---|---|---|--- -`query`| 是| string| —| 自然语言搜索查询 -`platform`| 否| string| —| 聚焦特定平台 -`min_results`| 否| int| 3| 最少返回结果数 -`max_results`| 否| int| 10| 最多返回结果数 - -### web_fetch — 网页内容抓取 +### `web_search` — Web 搜索 -参数| 必填| 类型| 默认值| 描述 ----|---|---|---|--- -`url`| 是| string| —| 有效的 HTTP/HTTPS 网址 - -### get_config_info — Grok 配置诊断 +| 参数 | 必填 | 类型 | 默认值 | 描述 | +| --- | --- | --- | --- | --- | +| `query` | 是 | string | — | 自然语言搜索查询 | +| `platform` | 否 | string | — | 聚焦特定平台 | +| `min_results` | 否 | int | `3` | 最少返回结果数 | +| `max_results` | 否 | int | `10` | 最多返回结果数 | + +### `web_fetch` — 网页内容抓取 + +| 参数 | 必填 | 类型 | 默认值 | 描述 | +| --- | --- | --- | --- | --- | +| `url` | 是 | string | — | 有效的 HTTP/HTTPS 网址 | + +### `get_config_info` — Grok 配置诊断 无参数。返回当前 Grok 配置信息并测试 API 连接。 -## 常见问题 +## ❓ 常见问题 -### 安装后命令找不到？ +### 安装后命令找不到？ -确认二进制文件已放到 `PATH` 目录中，且有执行权限。可运行 `which ikuncode-aimcp` 检查。 +确认二进制文件已放到 `PATH` 目录中，且有执行权限。可运行 `which oneinai-aimcp`（macOS / Linux）或 `where oneinai-aimcp`（Windows）检查。 -### Gemini 工具不可用？ +### Gemini 工具不可用？ -检查 `GEMINI_API_KEY` 环境变量是否正确设置，以及本地是否安装了 Gemini CLI。 +- 检查 `GEMINI_API_KEY` 环境变量是否正确设置 +- 确认本地是否已安装 Gemini CLI +- 参考 [Gemini CLI 部署文档](/deploy/gemini-cli) -### Grok 搜索返回错误？ +### Grok 搜索返回错误？ -运行 `get_config_info` 工具检查 API 配置和连接状态。 +运行 `get_config_info` 工具检查 API 配置和连接状态，确认 `GROK_API_KEY` 有效且账户可用。 -### 更多问题 +### 更多问题 -请查看 [FAQ]() 或联系[售后支持]()。 +请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。