zyc123/Aiapi-doc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

456

Browse Source
This commit is contained in:
zyc123 2026-05-14 18:02:52 +08:00
parent e0355d6a7f
commit 11548e854e
1 changed files with 128 additions and 155 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

221
skills/oneinai-aimcp.md
View File

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