Onion Server

FreeNot checked

A feature-rich MCP server offering 30 tools across AI, code, text, data, web, and system categories, enabling tasks like chat, translation, code review, web scr

by onion-ai

GitHub Embed

About

A feature-rich MCP server offering 30 tools across AI, code, text, data, web, and system categories, enabling tasks like chat, translation, code review, web scraping, and text processing.

README

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

PyPI License: MIT

✨ 工具列表（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 模板仓库

from github.com/onion-ai/mcp-server

Install Onion Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install onion-mcp-server

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add onion-mcp-server -- uvx --from git+https://github.com/onion-ai/mcp-server onion-mcp-server

FAQ

Is Onion Server MCP free?

Yes, Onion Server MCP is free — one-click install via Unyly at no cost.

Does Onion Server need an API key?

No, Onion Server runs without API keys or environment variables.

Is Onion Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Onion Server in Claude Desktop, Claude Code or Cursor?

Open Onion Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Gmail

Read, send and search emails from Claude

by Google

Slack

Send, search and summarize Slack messages

by Slack

Runbear

No-code MCP client for team chat platforms, such as Slack, Microsoft Teams, and Discord.

by Community

Discord Server

A community discord server dedicated to MCP by [Frank Fiegel](https://github.com/punkpeye)