MCD MCP Server

An MCP (Model Context Protocol) server that connects Claude AI to the MCD PaaS API. It allows Claude to query database table definitions from the Monoplus Cloud (Sinfonia Cloud) platform through natural language.

What it does

This server acts as a bridge between Claude Desktop and the MCD PaaS REST API. When Claude needs information about database tables — their structure, metadata, creation dates, or categories — it calls this server, which handles authentication and API communication behind the scenes.

Currently available tools:

• get_db_table_definition — Search for database table definitions by category name and/or table name.

Prerequisites

• Python 3.12+
• uv package manager
• Access to an MCD PaaS API instance
• Claude Desktop (for MCP integration)

Setup

1. Install dependencies:

   uv sync
   

2. Copy .env.sample to .env and fill in your credentials:

   cp .env.sample .env
   

   Required variables:

   Variable	Description
   MCD_PAAS_API_BASE	Base URL of the MCD PaaS API
   LOGIN_COMPANY_CD	Company code for authentication
   LOGIN_USER_ID	User ID
   LOGIN_PASSWORD	Password
   LOGIN_BRANCH_NAME	Branch name (e.g., develop)

3. Configure Claude Desktop by adding the server to claude_desktop_config.json (see config/claude_desktop_config.json for a reference). If running from WSL, make sure to use the correct distribution name and set "WSL_UTF8": "1" in the env block.

Running

# Via the wrapper script (used by Claude Desktop)
./run-mcp.sh

# Or directly
uv run python main.py

The server communicates over stdio using the MCP protocol. Debug logs are written to /tmp/mcp-debug.log.