
Gravity Forms 的 MCP 服务器——通过 AI 与 WordPress 表单、条目和提交交互
概览
一个用于Gravity Forms的模型上下文协议(MCP)服务器。通过任何兼容MCP的客户端,与你的WordPress表单、订阅源和条目交互。 由GravityKit为Gravity Forms社区打造。 - : 26 个工具,涵盖表单、条目、订阅、通知、提交和字段管理- : 智能字段操作,支持依赖跟踪,涵盖所有 46 种 Gravity Forms 字段类型 — 输入存储形状和entry_input提示,已与真实 Gravity Forms + 插件验证(GF 2.10 上轮转。
概述(AI 翻译)
一款用于Gravity Forms和GravityKit的模型上下文协议(MCP)服务器。通过任何兼容MCP的客户端,与你的WordPress表单、订阅源和条目交互。
由GravityKit为Gravity Forms社区打造。
特色
- 全重力表单覆盖:涵盖表单、条目、订阅源、通知、提交及现场管理的26种工具
- 智能字段管理:智能字段操作,涵盖所有46种Gravity Forms字段类型——输入存储形状和
entry_input提示,验证与真实Gravity Forms+插件(GF 2.10.3版本轮转) - 高级搜索:对条目的复杂筛选和搜索功能
- 表单提交:完整的提交流程及验证
- 附加集成:管理MailChimp、Stripe、PayPal等的订阅源
- GravityKit 产品:动态工具自动生成于网站的基金会能力目录,每个产品都配有其前缀:GravityView(
gv_*)、GravityBoard(gb_*)、GravityMigrate(gmig_*)和视觉合并标签(mergetags_*) - 类型安全:所有操作的全面验证
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
GravityKit MCP
A Model Context Protocol (MCP) server for Gravity Forms and GravityKit. Interact with your WordPress forms, feeds, and entries through any MCP-compatible client.
Built by GravityKit for the Gravity Forms community.
Features
- Full Gravity Forms Coverage: 26 tools across forms, entries, feeds, notifications, submissions, and field management
- Smart Field Management: Intelligent field operations with dependency tracking across all 46 Gravity Forms field types — entry-storage shapes and
entry_inputhints validated against real Gravity Forms + add-ons (round-tripped on GF 2.10.3) - Advanced Search: Complex filtering and searching capabilities for entries
- Form Submissions: Full submission workflow with validation
- Add-on Integration: Manage feeds for MailChimp, Stripe, PayPal, and more
- GravityKit Products: dynamic tools auto-generated from the site’s Foundation abilities catalog, each product under its own prefix: GravityView (
gv_*), GravityBoard (gb_*), GravityMigrate (gmig_*) and Visual Merge Tags (mergetags_*) - Type-Safe: Comprehensive validation for all operations
- Battle-Tested: Extensive offline + adversarial hardening suites, plus a self-seeding live harness that runs end-to-end against a real Gravity Forms site
Quick Start
Prerequisites
- Node.js 18+
- WordPress with Gravity Forms 2.5+
- WordPress site over HTTPS (recommended) — local
http://dev sites (localhost,*.test,*.local) work too
Installation
No clone or npm install needed — npx runs the published package on demand. (To run from a local checkout for development, see Contributing.)
-
Enable the Gravity Forms REST API (one-time, required for any credential type):
- Go to Forms → Settings → REST API and check Enable access to the API — Gravity Forms doesn’t register its REST routes without it.
-
Create credentials in WordPress (pick one):
Application password (recommended):
- Go to Users → Profile → Application Passwords
- Name it (e.g.
GravityKit MCP) and click Add New Application Password - Copy the generated password. Your username + this password are your credentials, and access follows your WordPress capabilities. On sites running GravityKit Foundation, the same credential also powers the GravityKit product tools.
Gravity Forms API key (for scoped access, e.g. a read-only key):
- On the same Forms → Settings → REST API screen, click Add Key
- Choose the user and permission level, then save the Consumer Key (
ck_…) and Secret (cs_…)
-
Add to your MCP client.
安装
npx -y @gravitykit/mcp配置
{
"mcpServers": {
"gravitykit-mcp": {
"command": "npx",
"args": ["-y", "@gravitykit/mcp"],
"env": {
"GRAVITY_FORMS_BASE_URL": "https://yoursite.com",
"GRAVITY_FORMS_CONSUMER_KEY": "your_wp_username",
"GRAVITY_FORMS_CONSUMER_SECRET": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}