QoutaMCP

MCP server for inspecting and analyzing project structures. Detects languages, frameworks, entry points, and dependencies.

🌐 Live API: https://mcp.qouta.id

Installation

Via NPX (Recommended)

npx qoutamcp

Via NPM

npm install -g qoutamcp
qoutamcp

Manual

git clone https://github.com/QoutaID/qoutaMcp.git
cd qoutaMcp
npm install
npm start

MCP Client Configuration

Method 1: Local (via NPX) - Full Filesystem Access

{
  "mcpServers": {
    "qoutaMcp": {
      "command": "npx",
      "args": ["-y", "qoutamcp"]
    }
  }
}

Method 2: Local (Manual Install)

{
  "mcpServers": {
    "qoutaMcp": {
      "command": "node",
      "args": ["C:/path/to/qoutaMcp/index.js"]
    }
  }
}

Method 3: Remote (via SSE) - Cloud Hosted

{
  "mcpServers": {
    "qoutaMcp": {
      "type": "sse",
      "url": "https://mcp.qouta.id/sse"
    }
  }
}

⚠️ Note: Remote mode has limited filesystem access (serverless). For full project inspection, use local mode.

Remote API Usage

Health Check

curl https://mcp.qouta.id/

Call Tools via REST API

# Detect Stack
curl -X POST https://mcp.qouta.id/ \
  -H "Content-Type: application/json" \
  -d '{"tool": "detect_stack", "params": {"path": "/tmp/myproject"}}'

# Inspect Project
curl -X POST https://mcp.qouta.id/ \
  -H "Content-Type: application/json" \
  -d '{"tool": "inspect_project", "params": {"path": "/tmp/myproject", "maxDepth": 3}}'

# List Key Files
curl -X POST https://mcp.qouta.id/ \
  -H "Content-Type: application/json" \
  -d '{"tool": "list_key_files", "params": {"path": "/tmp/myproject"}}'

Available Tools

1. inspect_project

Complete project snapshot - the primary tool for understanding a project.

Input:

{
  "path": "/path/to/project",
  "maxDepth": 3,
  "includeHidden": false
}

Output:

{
  "project": {
    "language": ["Node.js", "Python"],
    "type": "Web API",
    "confidence": 0.92
  },
  "frameworks": [
    { "name": "FastAPI", "confidence": 0.95 }
  ],
  "entryPoints": ["main.py"],
  "structureSummary": {
    "app": ["routes", "models"],
    "config": ["settings.py"]
  },
  "dependencies": {
    "primary": ["fastapi", "uvicorn"],
    "dev": ["pytest"]
  },
  "configFiles": [".env.example", "pyproject.toml"]
}

2. detect_stack

Lightweight and fast stack detection.

Input:

{
  "path": "/path/to/project"
}

Output:

{
  "runtime": ["Python"],
  "framework": ["FastAPI"],
  "databaseHints": ["PostgreSQL"],
  "frontend": null
}

3. list_key_files

List key files categorized by purpose.

Input:

{
  "path": "/path/to/project"
}

Output:

{
  "entry": ["main.py"],
  "config": ["pyproject.toml", ".env.example"],
  "docs": ["README.md"]
}

Supported Languages

Error Handling

All errors are returned as JSON:

{
  "error": {
    "code": "PATH_NOT_FOUND",
    "message": "Specified path does not exist"
  }
}

Self-Hosting

Run as HTTP/SSE Server

# Local development
npm run server

# With custom port
PORT=8080 node server.js

Deploy to Railway

1. Push to GitHub
2. Connect Railway to your repo
3. Set start command: node server.js
4. Deploy!

Deploy to Render

1. Create new Web Service
2. Connect to GitHub repo
3. Build command: npm install
4. Start command: node server.js

Deploy to Vercel (Serverless)

Already configured! Just connect your GitHub repo to Vercel.

Links

• 🌐 Live API: https://mcp.qouta.id
• 📦 NPM: https://www.npmjs.com/package/qoutamcp
• 🐙 GitHub: https://github.com/QoutaID/qoutaMcp

License

ISC