onion-mcp-server

onion-mcp-server

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.

Category
Visit Server

README

onion-mcp-server

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 工具可选

🔗 相关项目

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured