Skip to main content
Glama

NocoDB MCP Server

by gordo-v1su4

🚀 NocoDB MCP Server

A production-ready Model Context Protocol (MCP) server for seamless NocoDB integration with Cursor IDE.

🎯 What This Is

This MCP server provides Cursor IDE users with direct access to NocoDB operations without leaving their development environment. Perfect for Discord Heart Reactions workflow and other NocoDB automation projects.

✨ Features

  • Complete NocoDB API Integration - All CRUD operations supported
  • Discord Heart Reactions Optimized - Built specifically for the Discord workflow
  • Production Ready - Health checks, rate limiting, graceful shutdown
  • Docker Ready - Easy deployment with Docker or Coolify
  • Auto-deployment - GitHub Actions for automated builds
  • Comprehensive Monitoring - Built-in health checks and metrics

🚀 Quick Deployment

  1. Connect your GitHub repo to Coolify
  2. Set environment variables:
    • NOCODB_API_TOKEN=your_token
    • NOCODB_URL=https://nocodb.v1su4.com
  3. Deploy and enjoy!

Option 2: Docker

docker build -t mcp-server . docker run -p 3001:3001 -e NOCODB_API_TOKEN=your_token mcp-server

Option 3: Docker Compose

docker-compose up -d

🔧 Environment Variables

VariableRequiredDefaultDescription
NOCODB_API_TOKENYes-Your NocoDB API token
NOCODB_URLNohttps://nocodb.v1su4.comNocoDB instance URL
PORTNo3001Server port
NODE_ENVNoproductionEnvironment
LOG_LEVELNoinfoLogging level

📊 Available MCP Tools

Connection & Management

  • nocodb_test_connection - Test NocoDB connection
  • nocodb_list_projects - List all projects
  • nocodb_list_tables - List tables in project

Data Operations

  • nocodb_get_records - Retrieve records with pagination
  • nocodb_create_record - Create new records
  • nocodb_update_record - Update existing records
  • nocodb_delete_record - Delete records
  • nocodb_search_records - Search with filters

Specialized Tools

  • nocodb_create_discord_reactions_table - Create Discord reactions table
  • nocodb_get_analytics - Get Discord reactions analytics

🧪 Testing

Health Check

curl https://mcp.v1su4.com/health

Tools List

curl https://mcp.v1su4.com/tools

Test Tool Call

curl -X POST https://mcp.v1su4.com/call \ -H "Content-Type: application/json" \ -d '{"name": "nocodb_test_connection", "arguments": {"api_token": "your_token"}}'

📋 Cursor IDE Integration

  1. Update MCP Configuration:
    { "mcpServers": { "nocodb": { "command": "node", "args": ["/Users/your-username/Documents/Github/mcp-server/mcp-client-wrapper.js"], "env": { "MCP_SERVER_URL": "https://mcp.v1su4.com", "NOCODB_API_TOKEN": "${NOCODB_API_TOKEN}" } } } }
  2. Set Environment Variable:
    export NOCODB_API_TOKEN="your_nocodb_api_token"
  3. Restart Cursor and enjoy NocoDB tools!

🏗️ Architecture

Cursor IDE → Local MCP Wrapper → Hosted MCP Server → NocoDB API
  • Local Wrapper: Handles Cursor integration and communication
  • Hosted Server: Production server with all NocoDB operations
  • NocoDB API: Your actual database instance

📚 Documentation

🔒 Security

  • Rate limiting to prevent abuse
  • API token authentication required
  • HTTPS enforced
  • Comprehensive logging
  • Environment variable configuration

📈 Monitoring

  • Real-time health checks
  • Performance metrics
  • Request logging
  • Error tracking
  • Resource usage monitoring

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

📄 License

MIT License - feel free to use and modify as needed.

🆘 Support

For issues or questions:

  1. Check the health endpoint
  2. Review server logs
  3. Test with the CLI tools
  4. Check environment variables

Built for Discord Heart Reactions workflow 🎉

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables direct integration with NocoDB databases from Cursor IDE, providing complete CRUD operations, search capabilities, and specialized tools for Discord workflow automation. Features production-ready deployment with Docker support and comprehensive monitoring.

  1. 🎯 What This Is
    1. ✨ Features
      1. 🚀 Quick Deployment
        1. Option 1: Coolify (Recommended)
        2. Option 2: Docker
        3. Option 3: Docker Compose
      2. 🔧 Environment Variables
        1. 📊 Available MCP Tools
          1. Connection & Management
          2. Data Operations
          3. Specialized Tools
        2. 🧪 Testing
          1. Health Check
          2. Tools List
          3. Test Tool Call
        3. 📋 Cursor IDE Integration
          1. 🏗️ Architecture
            1. 📚 Documentation
              1. 🔒 Security
                1. 📈 Monitoring
                  1. 🤝 Contributing
                    1. 📄 License
                      1. 🆘 Support

                        Related MCP Servers

                        • -
                          security
                          F
                          license
                          -
                          quality
                          A protocol server that enables LLMs like Claude to interact with MongoDB databases, providing tools for schema exploration, aggregation queries, and data analysis through natural language in Cursor.
                          Last updated -
                          1
                          12
                          • Linux
                          • Apple
                        • -
                          security
                          F
                          license
                          -
                          quality
                          A tool that provides simple API to execute SQL queries and manage MySQL databases, designed to integrate with Cursor IDE for AI assistants to directly perform database operations.
                          Last updated -
                          • Linux
                          • Apple
                        • -
                          security
                          F
                          license
                          -
                          quality
                          A FastMCP-based server that provides complete Slack integration for Cursor IDE, allowing users to interact with Slack API features using natural language.
                          Last updated -
                        • -
                          security
                          A
                          license
                          -
                          quality
                          A Model Context Protocol server that integrates Cursor IDE with Bitbucket Cloud, allowing developers to fetch repository information and commit data directly from their Bitbucket workspace.
                          Last updated -
                          2
                          4
                          MIT License
                          • Apple
                          • Linux

                        View all related MCP servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/gordo-v1su4/mcp-server'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server