KCI MCP-Server

MCP-Server zur Suche und Analyse wissenschaftlicher Arbeiten auf Basis der KCI (Korea Citation Index) Open API

Nutzt die KCI Open API der National Research Foundation of Korea, um die Suche nach inländischen wissenschaftlichen Arbeiten, detaillierte Abfragen, Referenzanalysen und Zitationsindizes in Claude AI zu integrieren.

✨ Hauptmerkmale

• 7 Werkzeuge: Volle Unterstützung für Artikelsuche, Details, Referenzen, Zitationsindizes, Autorensuche und Schlagwortsuche

• Offizielle API-Konformität: Verwendung des offiziellen Endpunkts open.kci.go.kr und der MetaData-XML-Struktur

• 5 KCI-API-Typen: articleSearch / articleDetail / referenceSearch / citation / citationDetail

• STDIO + HTTP: Unterstützung für lokale (Claude Desktop) und Remote-Bereitstellungen

• TypeScript: Vollständige Typsicherheit und strukturierte Antworten

🚀 Installation und Verwendung

Methode 1: Direkte Nutzung über Claude.ai Web (keine Installation, am einfachsten)

Sie müssen nichts installieren, geben Sie einfach eine URL ein.

⚠️ Claude Pro / Max / Team / Enterprise Abonnement erforderlich (die kostenlose Version unterstützt nur 1 Connector)

So fügen Sie den Connector hinzu:

1. Melden Sie sich bei claude.ai an.

2. Klicken Sie unten links in der Seitenleiste auf Ihren Namen.

3. Wählen Sie "Einstellungen" (oder Settings).

4. Gehen Sie zum Menü "Connectors".

5. Klicken Sie auf die Schaltfläche "Custom Connector hinzufügen".

6. Geben Sie die folgenden Informationen ein:

   • Name: kci-mcp (beliebiger Name möglich)

   • URL: Ersetzen Sie im folgenden Link YOUR_KCI_API_KEY durch Ihren persönlichen KCI API-Schlüssel:

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

💡 KCI API-Schlüssel beantragen: KCI-Portal → Anmelden → Open API beantragen Beispielformat: https://kci-mcp.fly.dev/mcp?key=<Ihr_KCI_API_Schlüssel>

7. Nach dem Speichern können Sie den Connector sofort im Claude-Chat verwenden.

Anwendungsbeispiel:

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

Methode 2: Lokale Installation für Claude Desktop

Voraussetzungen

• Node.js 18+

Installation

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

Konfiguration von Claude Desktop

Öffnen Sie die Konfigurationsdatei unter folgendem Pfad:

💡 Abkürzung: Claude Desktop → Settings → Developer → Edit Config klicken

Fügen Sie der Konfigurationsdatei den folgenden Inhalt hinzu (ersetzen Sie diesen durch Ihren KCI API-Schlüssel):

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

⚠️ Unter Windows müssen Backslashes doppelt geschrieben werden: C:\Users\Benutzername\kci-mcp\dist\index.js

💡 KCI API-Schlüssel beantragen: KCI-Portal → Anmelden → Open API beantragen (kostenlos)

Starten Sie Claude Desktop vollständig neu, danach erscheint ein 🔨-Symbol unter dem Chat-Eingabefeld.

Methode 3: Claude Code (Terminal, für Entwickler)

# 전역 등록 (모든 프로젝트에서 사용, 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

Oder erstellen Sie eine .mcp.json-Datei im Projektstammverzeichnis:

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

✅ Installationsprüfung

🛠️ Werkzeugliste (7)

💬 Beispiel-Prompts

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

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

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

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

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

🔧 Direkte Ausführung (HTTP-Server-Modus)

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

📋 Umgebungsvariablen

📚 KCI Open API Informationen

🐳 Docker-Bereitstellung

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

📄 Lizenz

MIT

👤 Ersteller

Park Jeong Weon | 朴正元

🏫 Hankuk University of Foreign Studies, Division of Chinese Language, Literature and Culture

🏛️ Mitglied des AI-Sonderausschusses der Nationalen Bildungskommission 📋 AI-Talentförderungsteam des Bildungsministeriums

🌐 K-AI Bildungsnetzwerk: https://k-ai.it.kr/ 📧 auraweon7@gmail.com 📱 APP: kletter.kr / kteacher.kr