Servidor KCI MCP

Servidor MCP para la búsqueda y análisis de artículos académicos basado en la API abierta de KCI (Korea Citation Index)

Utiliza la API abierta de KCI de la Fundación Nacional de Investigación de Corea para integrar la búsqueda de artículos académicos nacionales, consultas detalladas, análisis de referencias y consultas de índices de citas con Claude AI.

✨ Características principales

• 7 herramientas: Soporte completo para búsqueda de artículos, detalles, referencias, índices de citas, búsqueda por autor y búsqueda por palabras clave.

• Cumplimiento de la API oficial: Utiliza el endpoint oficial open.kci.go.kr y la estructura XML de metadatos.

• 5 tipos de API de KCI: articleSearch / articleDetail / referenceSearch / citation / citationDetail

• STDIO + HTTP: Soporta tanto despliegue local (Claude Desktop) como remoto.

• TypeScript: Seguridad de tipos completa y respuestas estructuradas.

🚀 Instalación y uso

Método 1: Uso directo en la web de Claude.ai (Sin instalación, el más sencillo)

No necesita instalar nada, solo introduzca una dirección.

⚠️ Requiere plan Claude Pro / Max / Team / Enterprise (La versión gratuita solo permite 1 conector)

Cómo añadir el conector:

1. Inicie sesión en claude.ai.

2. Haga clic en su nombre en la parte inferior de la barra lateral izquierda.

3. Seleccione "Configuración" (o Settings).

4. Entre en el menú "Conectores" (o Connectors).

5. Haga clic en el botón "Añadir conector personalizado".

6. Introduzca la siguiente información:

   • Nombre: kci-mcp (puede elegir el nombre que desee)

   • URL: Reemplace la parte YOUR_KCI_API_KEY en la dirección de abajo con su propia clave de API de KCI:

https://kci-mcp.fly.dev/mcp?key=YOUR_KCI_API_KEY

💡 Obtención de la clave API de KCI: Portal KCI → Iniciar sesión → Solicitar Open API Formato de ejemplo: https://kci-mcp.fly.dev/mcp?key=<su_clave_API_KCI>

7. Guarde y podrá usarlo inmediatamente al volver al chat de Claude.

Ejemplo de uso:

AI 교육 관련 KCI 논문 최근 10건 검색해줘
2024년 KCI 인용지수 상위 20개 학술지 알려줘

Método 2: Instalación local en Claude Desktop

Preparación

• Node.js 18+

Instalación

git clone https://github.com/auraweon7-ship-it/kci-mcp.git
cd kci-mcp
npm install

Configuración de Claude Desktop

Abra el archivo de configuración en la siguiente ruta:

💡 Acceso rápido: Claude Desktop → Settings → Developer → Haga clic en Edit Config

Añada el siguiente contenido al archivo de configuración (reemplácelo con su clave API de KCI):

{
  "mcpServers": {
    "kci-mcp": {
      "command": "node",
      "args": ["/절대경로/kci-mcp/dist/index.js"],
      "env": {
        "KCI_API_KEY": "<발급받은_KCI_API_키>"
      }
    }
  }
}

⚠️ En la ruta de Windows, debe usar doble barra invertida: C:\Users\NombreUsuario\kci-mcp\dist\index.js

💡 Obtención de la clave API de KCI: Portal KCI → Iniciar sesión → Solicitar Open API (gratuito)

Reinicie completamente Claude Desktop y aparecerá un icono 🔨 en la parte inferior del chat.

Método 3: Claude Code (Terminal, para desarrolladores)

# 전역 등록 (모든 프로젝트에서 사용, API 키를 본인 키로 교체)
claude mcp add-json kci-mcp \
  '{"type":"stdio","command":"node","args":["/절대경로/kci-mcp/dist/index.js"],"env":{"KCI_API_KEY":"<발급받은_KCI_API_키>"}}' \
  --scope user

O cree un archivo .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "kci-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "KCI_API_KEY": "<발급받은_KCI_API_키>"
      }
    }
  }
}

✅ Verificación de la instalación

🛠️ Lista de herramientas (7)

💬 Ejemplo de prompt de uso

# 논문 검색
AI 교육 관련 논문 최근 10건 검색해줘

# 저자 검색
홍길동 교수 논문 목록 찾아줘

# 키워드 검색
딥러닝 키워드 논문 2022년 이후로 검색해줘

# 인용지수 조회
2024년 KCI 인용지수 상위 20개 학술지 알려줘

# 논문 상세 조회 (검색 결과의 articleId 사용)
ART002358582 논문 상세 정보 보여줘

🔧 Ejecución directa (Modo servidor HTTP)

# HTTP 모드로 실행 (원격 배포용)
KCI_API_KEY=<발급받은_KCI_API_키> node dist/index.js --http
# → http://localhost:3001/mcp
# → http://localhost:3001/health

📋 Variables de entorno

📚 Información de la API abierta de KCI

🐳 Despliegue con Docker

docker build -t kci-mcp .
docker run -e KCI_API_KEY=<발급받은_KCI_API_키> -p 3001:3001 kci-mcp

📄 Licencia

MIT

👤 Creador

Park Jeong Weon | 朴正元 | 박정원

🏫 Facultad de Lengua y Cultura China, Universidad Hankuk de Estudios Extranjeros     Division of Chinese Language, Literature and Culture     Hankuk University of Foreign Studies

🏛️ Miembro del Comité Especial de IA de la Comisión Nacional de Educación 📋 Equipo de Promoción de Talento en IA del Ministerio de Educación

🌐 Red de Educación K-AI: https://k-ai.it.kr/ 📧 auraweon7@gmail.com 📱 APP: kletter.kr / kteacher.kr