203 lines
5.8 KiB
Markdown
203 lines
5.8 KiB
Markdown
# ikuncode-aimcp - 统一 AI MCP 服务器
|
||
|
||
**一个二进制，三套 AI 引擎 — Gemini · Codex · Grok**
|
||
|
||
📋 简介
|
||
|
||
ikuncode-aimcp 是一个用 Rust 编写的统一 MCP 服务器，将 Gemini CLI、Codex CLI 和 Grok Search 整合到单个进程中。配置一次，即可在 Cursor / Windsurf / Claude Desktop 等任意 MCP 客户端中使用全部工具。
|
||
|
||
## 🔗 相关链接
|
||
|
||
资源| 地址
|
||
---|---
|
||
GitHub 仓库| [xuxu777xu/ikuncode-aimcp](<https://github.com/xuxu777xu/ikuncode-aimcp>)
|
||
ikun API| [api.ikuncode.cc](<https://api.oneinai.com>)
|
||
|
||
## ✨ 功能特点
|
||
|
||
* ✅ **一个二进制，全部工具** ：只需配置一个 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](</skills/ikunimage>)| Claude Code Skill| Claude Code 专用 — 文生图 / 图生图 / 并发批量生成
|
||
|
||
## 🛠️ 安装
|
||
|
||
### 方式一：下载预编译二进制（推荐）
|
||
|
||
从 [GitHub Releases](<https://github.com/xuxu777xu/ikuncode-aimcp/releases>) 下载对应平台的二进制文件：
|
||
|
||
平台| 文件名
|
||
---|---
|
||
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
|
||
|
||
1
|
||
2
|
||
|
||
### 方式二：npm 安装
|
||
|
||
bash
|
||
|
||
|
||
npm install -g ikuncode-aimcp
|
||
|
||
1
|
||
|
||
### 方式三：cargo 安装
|
||
|
||
bash
|
||
|
||
|
||
cargo install --git https://github.com/xuxu777xu/ikuncode-aimcp.git
|
||
|
||
1
|
||
|
||
### 方式四：从源码编译
|
||
|
||
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"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
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 — AI 任务执行
|
||
|
||
参数| 必填| 类型| 默认值| 描述
|
||
---|---|---|---|---
|
||
`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 秒）
|
||
|
||
### codex — AI 辅助编码
|
||
|
||
参数| 必填| 类型| 默认值| 描述
|
||
---|---|---|---|---
|
||
`PROMPT`| 是| string| —| 发送给 Codex 的任务指令
|
||
`cd`| 是| string| —| 工作目录路径
|
||
`sandbox`| 否| string| `read-only`| 沙箱策略
|
||
|
||
### web_search — Web 搜索
|
||
|
||
参数| 必填| 类型| 默认值| 描述
|
||
---|---|---|---|---
|
||
`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` 检查。
|
||
|
||
### Gemini 工具不可用？
|
||
|
||
检查 `GEMINI_API_KEY` 环境变量是否正确设置，以及本地是否安装了 Gemini CLI。
|
||
|
||
### Grok 搜索返回错误？
|
||
|
||
运行 `get_config_info` 工具检查 API 配置和连接状态。
|
||
|
||
### 更多问题
|
||
|
||
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。
|