KCI MCP сервер

MCP-сервер для поиска и анализа научных статей на основе открытого API KCI (Корейский индекс цитирования)

Использует открытый API KCI Национального исследовательского фонда Кореи для интеграции поиска отечественных научных статей, просмотра подробной информации, анализа библиографии и запросов индексов цитирования в Claude AI.

✨ Основные характеристики

• 7 инструментов: полная поддержка поиска статей, деталей, библиографии, индексов цитирования, поиска по авторам и ключевым словам

• Соответствие официальному API: использование официальной конечной точки open.kci.go.kr и структуры XML MetaData

• 5 типов API KCI: articleSearch / articleDetail / referenceSearch / citation / citationDetail

• STDIO + HTTP: поддержка как локального (Claude Desktop), так и удаленного развертывания

• TypeScript: полная типобезопасность и структурированные ответы

🚀 Установка и использование

Способ 1: Использование напрямую в веб-версии Claude.ai (без установки, самый простой)

Ничего устанавливать не нужно, достаточно ввести один адрес.

⚠️ Требуется подписка Claude Pro / Max / Team / Enterprise (в бесплатной версии доступен только 1 коннектор)

Как добавить коннектор:

1. Войдите на claude.ai.

2. Нажмите на свое имя в нижней части левой боковой панели.

3. Выберите "Настройки" (Settings).

4. Перейдите в меню "Коннекторы" (Connectors).

5. Нажмите кнопку "Добавить пользовательский коннектор".

6. Введите следующие данные:

   • Имя: kci-mcp (любое имя на ваш выбор)

   • URL: в адресе ниже замените YOUR_KCI_API_KEY на ваш ключ API KCI:

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

💡 Получение ключа API KCI: Портал KCI → Войти → Заявка на Open API Пример формата: https://kci-mcp.fly.dev/mcp?key=<ваш_ключ_KCI_API>

7. После сохранения вернитесь в чат Claude, и вы сможете сразу начать пользоваться.

Пример использования:

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

Способ 2: Локальная установка в Claude Desktop

Предварительные требования

• Node.js 18+

Установка

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

Настройка Claude Desktop

Откройте файл конфигурации по следующему пути:

💡 Быстрый способ: Claude Desktop → Settings → Developer → Нажмите Edit Config

Добавьте в файл конфигурации следующее содержимое (заменив на ваш ключ KCI API):

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

⚠️ В путях Windows обратную косую черту нужно указывать дважды: C:\Users\ИмяПользователя\kci-mcp\dist\index.js

💡 Получение ключа API KCI: Портал KCI → Войти → Заявка на Open API (бесплатно)

После полного перезапуска Claude Desktop в нижней части окна чата появится значок 🔨.

Способ 3: Claude Code (терминал, для разработчиков)

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

Или создайте файл .mcp.json в корне проекта:

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

✅ Проверка установки

🛠️ Список инструментов (7)

💬 Примеры промптов для использования

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

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

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

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

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

🔧 Запуск вручную (режим HTTP-сервера)

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

📋 Переменные окружения

📚 Информация о KCI Open API

🐳 Развертывание в Docker

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

📄 Лицензия

MIT

👤 Автор

Пак Чон Вон | 朴正元 | Park Jeong Weon

🏫 Факультет китайского языка и культуры, Колледж китаеведения, Университет иностранных языков Ханкук

🏛️ Член Специального комитета по ИИ при Национальном совете по образованию 📋 Группа по развитию талантов в области ИИ при Министерстве образования

🌐 Сеть K-AI образования: https://k-ai.it.kr/ 📧 auraweon7@gmail.com 📱 APP: kletter.kr / kteacher.kr