使用说明
MCP Maker-适用于任何数据源的MCP服务器生成器
在60秒内将Claude、Cursor、ChatGPT、Grok和DeepSeek连接到您的数据。
一个命令。没有代码。不需要MCP知识。生成一个 主控程序 任何MCP客户端的服务器，或者通过OpenRouter使用OpenAI、Grok、DeepSeek或500多种型号在终端中与您的数据库聊天。
pip install mcp-maker
mcp-maker init postgres://user:pass@host/mydb
mcp-maker config --install # wires it into Claude Desktop
重新启动Claude-它现在可以查询您的数据库了。
适用于：
| 数据库 | 电子表格和SaaS | 文件和API |
|---|---|---|
| PostgreSQL | Airtable | CSV/TSV/JSON/JSONL |
| MySQL | 概念 | Excel |
| SQLite | 谷歌表格 | REST API（OpenAPI/Swagger） |
| MongoDB | HubSpot | |
| Redis | 数据库 |
379项测试·麻省理工学院授权·对MCP Maker的运行时零依赖
🏆 评级 A–高品质 通过 MCPWorld
“此MCP服务器经过严格验证，提供全面的功能和高质量的用户体验。”
✔ 可用性已验证✔ 实用工具✔ 用户友好的安装✔ 详细的服务文档
为什么不直接让Claude或Cursor编写一个MCP服务器呢？
你可以——一张桌子和四个工具。MCP Maker存在于之后的一切：
- 每张桌子20多个正确的工具 --分页、排序、列选择、日期范围过滤器、全文搜索、运算符过滤器、聚合、不同值、批插入、外键连接、CSV/JSON导出。手动提示的服务器很少能正确分页和SQL引用，更不用说所有这些了。
- 模式感知，非提示感知 它 检查 您实际的数据库：主键、外键、视图、列注释、选择字段选项。没有什么是幻觉。
- 默认安全 --只读，除非通过
--ops insert,update,delete；按表RBAC；标识符到处逃逸；批量限制。 - 自动配置克劳德桌面 —
mcp-maker config --install你完了。 - 您拥有的独立文件 --生成的服务器对MCP Maker的运行时依赖性为零。卸载它；你的服务器一直在工作。
- 379次测试 支持生成的代码——每个连接器的输出都在CI中呈现和验证。
什么是MCP？ 这个 模型上下文协议 是将AI连接到外部工具和数据的开放标准。MCP Maker会自动从您的数据源生成一个完整的MCP服务器——您无需编写一行代码。
快速开始
生成MCP服务器（用于Claude、Cursor、ChatGPT）
pip install mcp-maker
# Generate from your database
mcp-maker init sqlite:///mydata.db
# Connect to Claude Desktop
mcp-maker config --install
# Restart Claude — your AI can now query your data
直接在您的终端上聊天
不需要克劳德——和你的 SQLite 从终端直接访问数据库：
pip install "mcp-maker[chat]"
# Chat with any SQLite database (no init required)
mcp-maker chat sqlite:///mydata.db
💡
init对chat:init为AI客户端（Claude、Cursor）生成服务器文件，并支持 所有13个连接器.chat允许您直接从终端进行查询——目前支持 仅限SQLite （PostgreSQL和MySQL即将推出）。
╭──────────────────────────────────╮
│ 💬 MCP-Maker Chat │
╰──────────── v0.2.7 ─────────────╯
📊 Connected: 3 tables (users, orders, products)
🔧 12 tools available (read-only)
🧠 Provider: OpenAI (gpt-4o-mini)
You > How many orders were placed this month?
🔧 count_orders(date_from='2026-03-01')
There were 47 orders placed this month.
You > Who is our top customer?
🔧 list_orders(order_by='total', order_dir='desc', limit=1)
Your top customer is Sarah Chen with $12,450 in orders.
法学硕士提供者： chat 支持 OpenAI, Grok（xAI）, 深度求索，以及 开放路由器 （500多种型号，包括克劳德、双子座、拉玛）：
# OpenAI (default)
mcp-maker chat sqlite:///data.db --api-key sk-xxx
# Grok — auto-detected from the xai- key prefix
mcp-maker chat sqlite:///data.db --api-key xai-xxx --model grok-3-mini
# DeepSeek — use --provider (DeepSeek keys share OpenAI's sk- prefix)
mcp-maker chat sqlite:///data.db --provider deepseek --api-key sk-xxx
# OpenRouter — auto-detected from the sk-or- key prefix
mcp-maker chat sqlite:///data.db --api-key sk-or-xxx --model anthropic/claude-sonnet-4
mcp-maker chat sqlite:///data.db --api-key sk-or-xxx --model google/gemini-2.5-flash
环境变量也起作用： OPENAI_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY, OPENROUTER_API_KEY （密钥来源的变量选择提供者）。
运作原理
Your Data Source MCP-Maker Output
┌──────────────┐ ┌──────────────────┐ ┌─────────────────────────┐
│ SQLite │ │ │ │ 📄 mcp_server.py │
│ PostgreSQL │ │ │ │ ↳ Editable, yours │
│ MySQL │───▶│ mcp-maker init │───▶│ │
│ Airtable │ │ │ │ ⚙️ _autogen_tools.py │
│ Google Sheets│ │ (auto-inspect) │ │ ↳ list_users() │
│ Notion │ │ (auto-generate) │ │ ↳ search_orders() │
│ CSV/JSON │ │ │ │ ↳ join_tasks_users() │
│ +6 more │ └──────────────────┘ └─────────────────────────┘
└──────────────┘ Standalone Python file ✅
Works forever, even after
uninstalling MCP-Maker
MCP制造商生成 独立Python文件。运行时不依赖于MCP Maker——生成后卸载它，服务器就会继续运行。
支持的连接器（13）
| 连接器 | URI格式 | Auth | 安装 |
|---|---|---|---|
| SQLite | sqlite:///my.db |
-- | 内置 |
| 文件 （CSV/TSV/JSON/jsonl） | ./data/ 或 ./users.csv |
-- | 内置 |
| PostgreSQL | postgres://user:pass@host/db |
DB信誉 | pip install "mcp-maker[postgres]" |
| MySQL | mysql://user:pass@host/db |
DB信誉 | pip install "mcp-maker[mysql]" |
| 气垫桌 | airtable://appXXXX |
API密钥 | pip install "mcp-maker[airtable]" |
| 谷歌表格 | gsheet://SPREADSHEET_ID |
服务帐户 | pip install "mcp-maker[gsheets]" |
| 概念 | notion://DATABASE_ID |
集成 | pip install "mcp-maker[notion]" |
| Excel | excel:///path.xlsx |
— | pip install "mcp-maker[excel]" |
| MongoDB | mongodb://… 或 mongodb+srv://… （阿特拉斯） |
DB信誉 | pip install "mcp-maker[mongodb]" |
| Supabase | supabase://PROJECT_REF |
API密钥 | pip install "mcp-maker[supabase]" |
| REST API | openapi:///spec.yaml |
API令牌 | pip install "mcp-maker[openapi]" |
| 瑞迪斯 | redis://host:6379/0 |
密码 | pip install "mcp-maker[redis]" |
| HubSpot | hubspot://pat=TOKEN |
帕特 | pip install "mcp-maker[hubspot]" |
# Install all connectors at once
pip install "mcp-maker[all]"
生成的工具
对于每个表/集合，MCP Maker生成：
| 工具 | 说明 |
|---|---|
list_{table} |
带过滤器、排序、字段选择、日期范围的分页列表 |
get_{table} |
按主键查找 |
search_{table} |
跨字符串列的全文搜索 |
count_{table} |
使用可选过滤器计数 |
insert_{table} |
插入一条记录*（带--ops insert)* |
update_{table} |
按ID*更新（带--ops update)* |
delete_{table} |
按ID*删除（带--ops delete)* |
batch_insert_{table} |
在一笔交易中批量插入多达1000条记录 |
batch_delete_{table} |
按ID批量删除 |
aggregate_{table} |
按聚合分组（计数、总和、平均值、最小值、最大值） |
distinct_{table} |
任何列的不同值 |
filter_{table} |
对文件/Excel/Mongo源进行基于运算符的过滤（eq、gt、lt、contains、…） |
join_{from}_with_{to} |
通过自动发现的外键进行跨表查询 |
call_api |
任何端点的通用逃逸舱口调用（OpenAPI来源） |
export_{table}_csv |
导出到CSV |
export_{table}_json |
导出为JSON |
基于标志的其他工具： --semantic （矢量搜索）， --webhooks （事件挂钩）， --audit （结构化日志）。
CLI参考
# Core
mcp-maker init <source> # Generate MCP server
mcp-maker chat <source> # Chat with your database (NEW)
mcp-maker serve # Run the generated server
mcp-maker inspect <source> # Dry run — preview what would be generated
# Configuration
mcp-maker config --install # Auto-configure Claude Desktop
mcp-maker env set KEY VALUE # Store API keys in .env
mcp-maker env list # List stored keys (masked)
mcp-maker list-connectors # Show available connectors
# Deployment
mcp-maker deploy --platform railway # Generate Railway deployment files
mcp-maker deploy --platform render # Render deployment
mcp-maker deploy --platform fly # Fly.io deployment
# Generation Options
mcp-maker init <source> --ops read,insert # Control what the LLM can do
mcp-maker init <source> --tables users,orders # Only expose specific tables
mcp-maker init <source> --async # Async tools (aiosqlite/asyncpg)
mcp-maker init <source> --auth api-key # Require MCP_API_KEY for access
mcp-maker init <source> --semantic # Enable ChromaDB vector search
mcp-maker init <source> --webhooks # Real-time event notifications
mcp-maker init <source> --audit # Structured JSON audit logging
mcp-maker init <source> --cache 60 # Cache reads for N seconds
mcp-maker init <source> --no-ssl # Disable SSL (local dev only)
mcp-maker init <source> --consolidate-threshold 10 # Consolidate large schemas
# Chat Options
mcp-maker chat <source> --api-key sk-xxx # OpenAI key
mcp-maker chat <source> --api-key sk-or-xxx # OpenRouter key (auto-detected)
mcp-maker chat <source> --model gpt-4o # Choose model
mcp-maker chat <source> --provider openrouter # Explicit provider
mcp-maker chat <source> --tables users # Limit to specific tables
架构与安全
非破坏性发电
MCP Maker生成两个文件：
mcp_server.py--您的可编辑入口点。添加自定义工具、业务逻辑、中间件。在重新生成时从不覆盖。_autogen_mcp_server.py--自动生成的工具。跑步时安全再生init再一次。
安全功能
| 特性 | 描述 |
|---|---|
| 凭证隔离 | 从加载的连接字符串和API密钥.env --从未嵌入生成的代码中 |
| 精细权限 | --ops read （默认）阻止写入。明确启用 insert, update, delete |
| API密钥认证 | --auth api-key 盖茨每一个工具调用后面 MCP_API_KEY 验证 |
| 默认SSL/TLS | PostgreSQL和MySQL连接强制加密传输 |
| SQL注入防护 | 对所有动态查询进行列白名单验证 |
| 批量限制 | 批量操作最多1000条记录，以防止资源耗尽 |
| 速率限制 | 用于云API（Airtable、Notion、Sheets）的内置令牌桶限制 |
架构版本控制
MCP制造商生成 .mcp-maker.lock 文件跟踪您的架构指纹。在重新生成时，它会检测更改（添加/删除的表和列），并在更新工具之前显示颜色编码的迁移差异。
大模式处理
对于包含20多个表的模式 --consolidate-threshold 标志从按表工具切换到合并的通用工具（例如。， query_database)，防止LLM上下文窗口溢出。
MCP客户端兼容性
生成的服务器可与任何兼容MCP的客户端配合使用：
| 客户端 | 安装程序 |
|---|---|
| Claude 桌面版 | mcp-maker config --install （自动） |
| 光标 | 添加到光标设置→ MCP服务器 |
| 帆板运动 | 添加到~/.codeium/windsurf/mcp_config.json |
| VS代码+继续 | 添加到Continue的MCP配置 |
| ChatGPT桌面 | OpenAI MCP支持（推出） |
| 任何MCP客户端 | 快跑mcp-maker serve 并指向它 |
安装
# Core (SQLite + Files + CLI)
pip install mcp-maker
# With chat support (OpenAI / Grok / DeepSeek / OpenRouter)
pip install "mcp-maker[chat]"
# With specific connectors
pip install "mcp-maker[postgres]"
pip install "mcp-maker[airtable]"
pip install "mcp-maker[gsheets]"
pip install "mcp-maker[notion]"
# With async support
pip install "mcp-maker[async-sqlite]"
pip install "mcp-maker[async-postgres]"
pip install "mcp-maker[async-mysql]"
# Everything
pip install "mcp-maker[all]"
要求： Python 3.10+
📖 文档
| 指南 | 说明 |
|---|---|
| 入门指南 | 安装，第一台服务器，Claude Desktop设置 |
| CLI和架构参考 | 所有命令、环境变量、安全详细信息 |
连接器导轨
每个指南都包括分步设置、示例和故障排除：
| 连接器 | 指南 |
|---|---|
| SQLite | docs/sqlite.md |
| 文件（CSV/JSON） | docs/files.md |
| PostgreSQL | docs/postgresql.md |
| MySQL | docs/mysql.md |
| 气垫桌 | docs/airtable.md |
| 谷歌表格 | docs/google-sheets.md |
| 概念 | docs/notion.md |
| Excel | docs/excel.md |
| MongoDB | docs/mongodb.md |
| Supabase | docs/supabase.md |
| REST API（OpenAPI） | docs/openapi.md |
| Redis | docs/redis.md |
| HubSpot | docs/hubspot.md |
| 语义搜索 | docs/语义搜索.md |
贡献
MCP Maker是为社区贡献而设计的——每个连接器都是一个自包含的PR。
看 贡献.md 获取分步指南。
git clone https://github.com/MrAliHasan/mcp-maker.git
cd mcp-maker
make install # Set up dev environment
make check # Run lint + tests (379 tests)
安全
发现漏洞？请通过以下方式私下报告 安全.md.
