API_Univ MCP Server (npm package) v2.0

University admission information query MCP server for Claude Desktop. ✅ v2.0 완전 구현 성공! 🌐 원격 연결 대폭 개선!

Installation

Global installation

npm install -g api-univ

Local installation

npm install api-univ

Usage

Local Execution

Run locally on the same machine:

# Windows
start_mcp_npm.bat

# Linux/Mac
./start_mcp_npm.sh

# Direct execution
npx api-univ

Remote Execution (Case-8) 🆕 대폭 개선됨

Run on a remote server accessible from other machines with smart detection and automatic SQL cleanup:

# Windows
start_mcp_npm_remote.bat

# Linux/Mac
./start_mcp_npm_remote.sh

# Python (cross-platform)
python start_mcp_npm_remote.py

🔧 최신 개선사항 (2025-07-15):

• ✅ 스마트 패키지 감지: 전역 vs 로컬 npm 패키지 자동 선택
• ✅ SQL 마크다운 블록 제거: OpenAI 응답의 ```sql 블록 자동 정리
• ✅ 안정성 향상: 개선된 TCP 통신 및 오류 처리

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "api-univ": {
      "command": "npx",
      "args": ["@api-univ/mcp-server"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "api-univ": {
      "command": "api-univ-mcp"
    }
  }
}

For Windows WSL (Recommended):

{
  "mcpServers": {
    "api-univ": {
      "command": "wsl",
      "args": ["-e", "/home/kimsoph/.npm-global/bin/api-univ-mcp"]
    }
  }
}

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run built version
npm start

Available Tools

• query_university: Query university admission information using natural language (OpenAI GPT-4o)
• search_universities: Search for universities by name or region (with university name mapping)
• get_department_info: Get detailed information about a specific department

Resources

• university://schema: Database schema information
• university://stats: Database statistics

Requirements

• Node.js >= 18.0.0
• OpenAI API key in .env file
• SQLite database at DB/2025_eTus.db