onion-mcp-server

A feature-rich MCP Server for onion-ai — 30 tools across 6 categories.

✨ 工具列表（30 个）

分组	工具	说明
🤖 AI	ai_chat	多轮对话，支持历史和 system prompt
🤖 AI	ai_translate	智能翻译，40+ 语言，自动检测源语言
🤖 AI	ai_summarize	长文摘要（要点/段落/一句话）
🤖 AI	ai_rewrite	文本改写（正式/口语/简洁/扩写）
🤖 AI	ai_extract	结构化信息提取（人名/地名/关键词等）
🤖 AI	ai_classify	文本分类（情感/主题/意图/自定义）
💻 Code	code_explain	解释代码逻辑
💻 Code	code_review	代码审查（Bug/安全/性能/风格）
💻 Code	code_generate	根据描述生成代码
💻 Code	code_convert	代码语言转换
💻 Code	code_fix	修复代码错误
💻 Code	code_docstring	生成文档注释
📝 Text	text_format	JSON/YAML/纯文本格式化
📝 Text	text_diff	文本差异对比（unified diff）
📝 Text	text_template	模板渲染（{变量} 语法）
📝 Text	text_count	字数/行数/Token 统计
📝 Text	text_clean	清理文本（去空行/去重/标准化）
📊 Data	data_json_query	JSONPath 风格查询
📊 Data	data_csv_analyze	CSV 数据分析与统计
📊 Data	data_table_format	数据转 Markdown 表格
📊 Data	data_convert	JSON/CSV/YAML/TOML 互转
🌐 Web	web_fetch	抓取网页内容（返回纯文本）
🌐 Web	web_search	DuckDuckGo 搜索（无需 API Key）
🌐 Web	web_extract	提取网页结构化信息
⚙️ System	sys_time	获取当前时间（支持时区）
⚙️ System	sys_uuid	生成 UUID（v1/v4）
⚙️ System	sys_hash	计算 Hash（md5/sha256 等）
⚙️ System	sys_base64	Base64 编解码
⚙️ System	sys_url_encode	URL 编解码
⚙️ System	sys_json_valid	JSON 格式验证

🚀 快速开始

方式一：通过 onion CLI（推荐）

# 1. 设置 API Key
export ONION_MCP_API_KEY=sk-...
export ONION_MCP_MODEL=gpt-4o-mini        # 可选，默认 gpt-4o-mini
export ONION_MCP_BASE_URL=https://...     # 可选，兼容 DeepSeek/Qwen/Ollama

# 2. 添加到 onion
onion mcp add onion-mcp \
  -c uvx \
  -a '["onion-mcp-server"]' \
  --env '{"ONION_MCP_API_KEY":"sk-...","ONION_MCP_MODEL":"gpt-4o-mini"}'

# 3. 测试
onion mcp inspect onion-mcp
onion mcp call onion-mcp sys_time '{}'
onion mcp call onion-mcp ai_translate '{"text":"Hello world","target_language":"中文"}'

方式二：Claude Desktop / Cursor

# 导出配置
onion mcp config --claude-format

或手动添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "onion-mcp": {
      "command": "uvx",
      "args": ["onion-mcp-server"],
      "env": {
        "ONION_MCP_API_KEY": "sk-...",
        "ONION_MCP_MODEL": "gpt-4o-mini"
      }
    }
  }
}

方式三：本地开发

git clone https://github.com/onion-ai/mcp-server
cd mcp-server
pip install -e ".[all]"

export ONION_MCP_API_KEY=sk-...
python -m onion_mcp_server

⚙️ 环境变量

变量	说明	默认值
ONION_MCP_API_KEY	API Key（必填，AI 工具需要）	—
ONION_MCP_BASE_URL	API Base URL	https://api.openai.com/v1
ONION_MCP_MODEL	模型名称	gpt-4o-mini
ONION_MCP_MAX_TOKENS	最大输出 Token	4096

兼容任何 OpenAI 格式接口：DeepSeek、通义千问、Moonshot、本地 Ollama 等

📦 依赖说明

依赖	用途	是否必须
mcp	MCP 协议	✅ 必须
openai	AI 工具调用 LLM	AI 工具需要
httpx	web 工具网络请求	web 工具需要
beautifulsoup4	web 工具 HTML 解析	web 工具需要
pyyaml	YAML 格式支持	data/text 工具可选

🔗 相关项目

• onion-ai/onion — onion CLI 主项目
• onion-ai/skill-hub — Skill 模板仓库