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
| 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"
}
}
Self-Hosting
Run as HTTP/SSE Server
# Local development
npm run server
# With custom port
PORT=8080 node server.js
Deploy to Railway
- Push to GitHub
- Connect Railway to your repo
- Set start command:
node server.js - Deploy!
Deploy to Render
- Create new Web Service
- Connect to GitHub repo
- Build command:
npm install - 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
