Used as a JavaScript runtime for the MCP server, mentioned as the default runtime in the package.json scripts.
Supported as an alternative runtime for the MCP server.
Package manager used to install and run the MCP server.
Alternative package manager supported for installation and running the MCP server.
Provides type safety and enterprise-grade development support for the MCP server implementation.
Alternative package manager supported for installation and running the MCP server.
@mingdaocloud/hap-mcp
HAP (Hyper Application Platform) is an APaaS platform launched by Mingdao (https://www.mingdao.com) that helps you rapidly build enterprise-grade applications with no coding. This is the MCP (Model Context Protocol) server by HAP for seamless AI integration.
🚀 Quick Start with MCP Client (e.g. cursor)
1. Configure cursor MCP Settings (Need Node.js 18+)
Add the following configuration to your cursor settings:
Option A: Standard Configuration (SaaS Version)
Create or edit ~/.cursor/mcp.json
:
Option B: Private Deployment Configuration
For private deployment environments only. Create .cursor/mcp.json
in your project root:
Note: The HOST
parameter is only required for private deployment environments. Replace https://www.nocoly.com
with your actual private deployment server URL.
2. Start Using in cursor
After configuration, true on the hap-mcp
tool and you'll have access to all HAP API tools directly in your AI conversations!
📋 Alternative Installation Methods
🔭 What's Included
HAP provides:
Production-ready MCP server with both stdio and HTTP transport options
Complete HAP API integration - Full access to HAP Application APIs
Pre-built tools for common AI integration tasks
Extensible architecture for custom tools, resources, and prompts
TypeScript support with full type safety
Easy deployment and configuration
✨ Features
FastMCP Framework: Built on the robust FastMCP framework
Dual Transport Support: Run over stdio or HTTP for maximum flexibility
HAP API Tools: Complete set of tools for HAP application operations
TypeScript: Full TypeScript support for enterprise-grade development
Production Ready: Optimized for production deployments
Extensible: Easy to extend with custom functionality
🔧 HAP API Tools
hap-mcp
includes a complete set of tools for interacting with the HAP application:
Available Tools (28 Tools)
Core Worksheet Operations (9 Tools)
add_worksheet_record: Add new records to worksheets
delete_worksheet_record: Delete records from worksheets
update_worksheet_record: Update existing records
get_worksheet_fields: Get worksheet field information
list_worksheet_records: List records with filtering and pagination
list_worksheets: List all worksheets in application
get_worksheet_pivot_data: Get pivot table data with aggregation
create_worksheet: Create new worksheets with controls
get_worksheet_record_detail: Get detailed information of specific records
Batch Operations (2 Tools)
add_worksheet_records_batch: Bulk create multiple records
update_worksheet_records_batch: Bulk update multiple records
Advanced Features (5 Tools)
get_app_info: Get application information including groups, worksheets, and custom pages
get_related_worksheet_records: Get records from linked worksheets
get_worksheet_record_share_link: Generate sharing links for records
get_worksheet_record_count: Get total record count in worksheets
get_worksheet_record_logs: Get operation history for records
Role Management (7 Tools)
get_roles: List application roles
create_role: Create new roles with permissions
delete_role: Delete roles
add_role_members: Add users to roles
remove_role_members: Remove users from roles
get_role_detail: Get detailed role information
exit_app: Kick someone off from application
Option Set Management (4 Tools)
create_option_set: Create new option sets
get_option_set: Get option set information
update_option_set: Update existing option sets
delete_option_set: Delete option sets
Utility Tools (1 Tools)
get_area_info: Get geographical area information
Quick Example
🚀 Getting Started
After creating your project:
Install dependencies using your preferred package manager:
# Using npm npm install # Using yarn yarn # Using pnpm pnpm install # Using bun bun installStart the server:
# Start the stdio server npm start # Or start the HTTP server npm run start:httpFor development with auto-reload:
# Development mode with stdio npm run dev # Development mode with HTTP npm run dev:http
Note: The default scripts in package.json use Bun as the runtime (e.g.,
bun run src/index.ts
). If you prefer to use a different package manager or runtime, you can modify these scripts in your package.json file to use Node.js or another runtime of your choice.
📖 Detailed Usage
Transport Methods
The MCP server supports two transport methods:
stdio Transport (Command Line Mode):
Runs on your local machine
Managed automatically by MCP Client (e.g. cursor)
Communicates directly via
stdout
Only accessible by you locally
Ideal for personal development and tools
SSE Transport (HTTP Web Mode):
Can run locally or remotely
Managed and run by you
Communicates over the network
Can be shared across machines
Ideal for team collaboration and shared tools
Running the Server Locally
stdio Transport (CLI Mode)
Start the server in stdio mode for CLI tools:
HTTP Transport (Web Mode)
Start the server in HTTP mode for web applications:
By default, the HTTP server runs on port 3001. You can change this by setting the PORT environment variable:
Connecting to the Server
Connecting from Cursor
To connect to your MCP server from Cursor:
Open Cursor and go to Settings (gear icon in the bottom left)
Click on "Features" in the left sidebar
Scroll down to "MCP Servers" section
Click "Add new MCP server"
Enter the following details:
Server name:
my-mcp-server
(or any name you prefer)For stdio mode:
Type:
command
Command: The path to your server executable, e.g.,
npm start
For SSE mode:
Type:
url
URL:
http://localhost:3001/sse
Click "Save"
Using mcp.json with Cursor
For a more portable configuration, create an .cursor/mcp.json
file in your project's root directory:
Standard Configuration (SaaS Version):
Private Deployment Configuration:
You can also create a global configuration at ~/.cursor/mcp.json
to make your MCP servers available in all your Cursor workspaces.
Environment Variables:
APPKEY
(required): Your Mingdao application keySIGN
(required): Your Mingdao signatureHOST
(optional): Custom host URL for private deployment only (e.g., https://www.nocoly.com). If provided, API calls will usehost/api
instead ofhttps://api.mingdao.com
Note:
The
command
type entries run the server in stdio modeThe
url
type entry connects to the HTTP server using SSE transportYou can provide environment variables using the
env
fieldWhen connecting via SSE with FastMCP, use the full URL including the
/sse
path:http://localhost:3001/sse
Testing Your Server with CLI Tools
FastMCP provides built-in tools for testing your server:
Using Environment Variables
You can customize the server using environment variables:
🛠️ Adding Custom Tools and Resources
When adding custom tools, resources, or prompts to your FastMCP server:
Tools
Resources
Prompts
📚 Documentation
For more information about FastMCP, visit FastMCP GitHub Repository.
For more information about the Model Context Protocol, visit the MCP Documentation.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that provides seamless integration with Mingdao platform APIs, enabling AI applications to perform operations like worksheet management, record manipulation, and role management through natural language.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI models to interact with both MySQL and MongoDB databases through a standardized interface, supporting comprehensive database operations including queries, schema management, and CRUD operations.Last updated -146MIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -331
- AsecurityAlicenseAqualityA server implementing the Model Context Protocol (MCP) that connects YindDao AI Power with MCP Hosts, enabling AI to utilize RPA capabilities for workflow automation.
YingDao RPA MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that enables AI platforms to invoke RPA (Robotic Process Automation) capabilities from YingDao, allowing automated execution of repetitive tasks through AI interactions.Last updated -36741MIT License