QoutaMCP

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

Installation

Via NPX (Recommended)

npx qoutamcp

Manual

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

MCP Client Configuration

Add to your MCP client config (e.g., mcp_config.json):

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

Or if installed locally:

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

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

| Language | Signature Files | Frameworks Detected | |----------|-----------------|---------------------| | Node.js/TS | package.json, tsconfig.json | React, Next.js, Express, Vite, NestJS | | Python | requirements.txt, pyproject.toml | Flask, FastAPI, Django, Streamlit | | PHP | composer.json | Laravel, Symfony | | Go | go.mod | Gin, Fiber, Echo | | Java | pom.xml, build.gradle | Spring Boot | | Rust | Cargo.toml | Actix, Rocket, Axum |

Error Handling

All errors are returned as JSON:

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

Remote Deployment

Run as HTTP/SSE Server

# Local
npm run server

# Or 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)

Create vercel.json:

{
  "version": 2,
  "builds": [{ "src": "server.js", "use": "@vercel/node" }],
  "routes": [{ "src": "/(.*)", "dest": "server.js" }]
}

Connect Remote MCP

After deployment, configure your MCP client:

{
  "mcpServers": {
    "qoutaMcp": {
      "type": "sse",
      "url": "https://your-deployed-url.com/sse"
    }
  }
}

License

ISC