terminalServer (MCP server for pythonRestModule)

This MCP server exposes one MCP tool per REST endpoint from your pythonRestModule FastAPI service.

Tools exposed

• customer_data → POST /customer/data
• product_offers → POST /customers/{customer_id}/offers
• assigned_products → POST /customer/assigned-products
• health_check → GET /health

Configuration

• REST_BASE_URL: base URL of the REST service (default http://127.0.0.1:8000)
  • Example: http://127.0.0.1:18080

Install & build

cd C:\mDev\mcp-server\terminalServer
npm install
npm run build

Run (stdio transport)

$env:REST_BASE_URL="http://127.0.0.1:8000"
npm run start

Dev run (no build)

$env:REST_BASE_URL="http://127.0.0.1:8000"
npm run dev

Quick test with MCP Inspector (optional)

npm run build
npm run inspector

Cursor / Claude Desktop config (example)

Option B: npx (portable, recommended)

After you publish this as an npm package, users can integrate without hardcoding paths:

{
  "mcpServers": {
    "terminalServer": {
      "command": "npx",
      "args": ["-y", "terminalserver-rest-mcp@latest"],
      "env": {
        "REST_BASE_URL": "http://127.0.0.1:8000"
      }
    }
  }
}

Local dev (path-based)

If someone cloned the repo locally, they can still run via:

• npm run build
• then point to the built entry:

{
  "mcpServers": {
    "terminalServer": {
      "command": "node",
      "args": ["<path-to-clone>\\\\build\\\\bin.js"],
      "env": {
        "REST_BASE_URL": "http://127.0.0.1:8000"
      }
    }
  }
}