mcp-pro

SabirAliyev/mcp-pro

3.1

If you are the rightful owner of mcp-pro and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP Pro is a Dockerized Custom MCP Server designed to provide secure and efficient access to various development resources and tools, all within a containerized environment.

Tools
6
Resources
0
Prompts
0

MCP Pro – Dockerized Custom MCP Server for Cursor (2025)

A fully containerized Model Context Protocol (MCP) server that gives Claude instant read-only access to your files, Git, PostgreSQL, Docker logs, and safe shell commands — all running inside Docker with zero host installation required.

Features

  • read_file – read any file from your projects (strictly read-only)
  • list_dir – list directory contents
  • git_diff – git diff between any refs
  • postgres_query – SELECT-only queries (INSERT/UPDATE/DELETE blocked)
  • docker_logs – container logs on demand
  • safe_shell – whitelisted commands (php artisan, composer, symfony console, etc.)

All tools are 100 % safe and confined to your Docker volumes.

Repository layout

~/mcp-pro/
├── docker-compose.yml
├── Dockerfile
├── package.json
├── tsconfig.json
└── src/
    └── index.ts

How to start the server (one command)

cd ~/mcp-pro
docker compose up -d --build

The container mcp-pro will be running (no exposed HTTP port – it uses stdio).

How to add the MCP server in Cursor (2.1.17+)

  1. Open Cursor → Settings → Features → Tools & MCP
  2. Click Add Custom MCP (opens ~/.cursor/mcp.json)
  3. Replace the entire contents with the following (replace ONLY the password):
{
  "mcpServers": {
    "local-pro-stdio": {
      "type": "stdio",
      "command": "docker exec -i mcp-pro node /app/dist/index.js",
      "env": {
        "POSTGRES_PASSWORD": "your_real_postgres_password_here",
        "POSTGRES_HOST": "host.docker.internal",
        "POSTGRES_PORT": "5432",
        "POSTGRES_DB": "your_db_name",
        "POSTGRES_USER": "your_db_user",
        "PROJECTS_DIR": "/projects"
      },
      "name": "Local Dev MCP Pro (Docker stdio)",
      "enabled": true
    }
  }
}
  1. Save the file (Ctrl+S)
  2. Fully restart Cursor (quit the AppImage and start it again)

After restart you will see Local Dev MCP Pro (Docker stdio) with a green dot and the 6 tools listed.

Updating / rebuilding

Whenever you change src/index.ts or any file:

cd ~/mcp-pro
docker compose up -d --build
# then fully restart Cursor again

No npm install or npm run build is ever needed on the host – everything happens inside the container during the image build.

Security notes

  • File tools are strictly confined to /projects (your /home/sa/src)
  • PostgreSQL tool only allows SELECT/EXPLAIN/SHOW/WITH queries
  • safe_shell whitelist is in src/index.ts – edit it if you need more commands
  • Docker socket is mounted read-only

You now have one of the most powerful and safest local MCP setups available in 2025.

Enjoy 5–10× token savings and lightning-fast Claude assistance on Yii → Symfony/Laravel migrations! 🚀