JotForm API - Python Client & MCP Server

基本能力

产品定位

JotForm API - Python Client & MCP Server 是一个基于 JotForm API 的 Python 客户端和 MCP (Model Context Protocol) 服务器。该服务器允许通过标准化工具与 JotForm API 进行交互，提供了一系列用于管理表单、提交、用户、文件夹和报告的工具。

核心功能

• 用户工具：获取用户账户详情、使用统计、设置等。
• 表单工具：创建、删除、克隆表单，管理表单问题和属性。
• 提交工具：获取、创建、编辑和删除表单提交。
• 文件夹工具：管理表单文件夹。
• 报告工具：创建和管理报告。
• 自定义工具：如按日期范围搜索提交。

适用场景

• 自动化表单管理
• 批量处理表单提交
• 集成 JotForm API 到现有系统
• 开发基于 JotForm 的自定义应用

工具列表

• 用户工具：get_user, get_usage, get_submissions, get_subusers, get_settings, update_settings, get_history, register_user, login_user, logout_user
• 表单工具：get_forms, get_form, get_form_questions, get_form_question, create_form, create_forms, delete_form, clone_form, delete_form_question, create_form_question, create_form_questions, edit_form_question, get_form_properties, get_form_property, set_form_properties, set_multiple_form_properties, get_form_files, get_form_webhooks, create_form_webhook, delete_form_webhook, get_form_reports, create_report
• 提交工具：get_form_submissions, create_form_submission, create_form_submissions, get_submission, delete_submission, edit_submission
• 文件夹工具：get_folders, get_folder, create_folder, delete_folder, update_folder, add_forms_to_folder, add_form_to_folder
• 报告工具：get_reports, get_report, delete_report
• 系统工具：get_plan
• 自定义工具：search_submissions_by_date

常见问题解答

• 认证问题：确保提供正确的 JotForm API 密钥。
• 安装问题：确保 Python 版本为 3.11+，并正确安装依赖。
• 运行问题：确保端口未被占用，且环境变量正确设置。

使用教程

使用依赖

• Python 3.11+
• git

安装教程

通过 Smithery 安装（推荐）

1. 在 MCP 客户端的服务器管理界面中搜索服务器。
2. 查找 JotForm API Server 或使用 ID @The-AI-Workshops/jotform-mcp-server。
3. 选择服务器并点击“安装”。
4. 配置环境变量，最重要的是 JOTFORM_API_KEY。

手动安装

1. 克隆仓库：

git clone https://github.com/The-AI-Workshops/jotform-mcp-server.git
cd jotform-mcp-server

1. 创建虚拟环境：

python3 -m venv venv
source venv/bin/activate  # Windows 使用 `venv\Scripts\activate`

1. 安装依赖：

pip install -r requirements.txt

1. 配置 API 密钥：
2. 重命名 .env.example 为 .env。
3. 替换 JOTFORM_API_KEY 为你的实际 API 密钥。
4. 运行服务器：

python jotform_mcp_server.py

使用 Docker 安装

1. 构建 Docker 镜像：

docker build -t jotform-mcp-server .

1. 运行 Docker 容器：

docker run -d -p 8067:8067 -e JOTFORM_API_KEY="YOUR_ACTUAL_JOTFORM_API_KEY" --name jotform-server jotform-mcp-server

调试方式

• 查看日志：

docker logs jotform-server

• 停止容器：

docker stop jotform-server

• 删除容器：

docker rm jotform-server

许可证

该项目遵循 GPL-2.0 开源许可条款，请参阅 GPL-2.0 了解完整条款。