AI导哈

项目结构分析工具

QoutaMCP是一个用于检查和分析项目结构的服务器工具，能够检测语言、框架、入口点和依赖关系。

  • by QoutaID
  • JavaScript
  • 混合部署
  • 1 星标
  • 更新于
在 GitHub 查看 QoutaID/qoutaMcp

使用说明

QoutaMCP

用于检查和分析项目结构的MCP服务器。检测语言、框架、入口点和依赖关系。

🌐 实时API: https://mcp.qouta.id

安装

通过NPX（推荐）

npx qoutamcp

通过NPM

npm install -g qoutamcp
qoutamcp

手册

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

MCP客户端配置

方法1：本地（通过NPX）-完全文件系统访问

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

方法2：本地（手动安装）

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

方法3：远程（通过SSE）-云托管

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

⚠️ 备注：远程模式具有有限的文件系统访问权限（无服务器）。对于完整的项目检查，请使用本地模式。

远程API使用

健康检查

curl https://mcp.qouta.id/

通过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"}}'

可用工具

1. inspect_project

完整的项目快照——理解项目的主要工具。

输入：

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

输出：

{
  "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

轻量级和快速的堆栈检测。

输入：

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

输出：

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

3. list_key_files

列出按用途分类的关键文件。

输入：

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

输出：

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

支持的语言

检测到语言 签名文件 框架
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，交响乐。
去吧 go.mod 杜松子酒、纤维、Echo
Java pom.xml, build.gradle 弹簧靴
生锈 Cargo.toml Actix、火箭、Axum

错误处理

所有错误均以JSON格式返回：

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

自我寄宿

以HTTP/SSE服务器运行

# Local development
npm run server

# With custom port
PORT=8080 node server.js

部署到铁路

  1. 推送到GitHub
  2. 将Railway连接到您的仓库
  3. 设置启动命令： node server.js
  4. 部署！

部署以渲染

  1. 创建新的Web服务
  2. 连接到GitHub仓库
  3. 构建命令： npm install
  4. 启动命令： node server.js

部署到Vercel（无服务器）

已配置！只需将您的GitHub仓库连接到Vercel即可。

链接

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

许可证

ISC

相关 MCP