MCP-сервер Global Papers

Интегрированный MCP-сервер для поиска зарубежных научных статей — объединяет API OpenAlex, Semantic Scholar, CrossRef и arXiv.

⚡ Быстрый старт (5 минут)

🎯 2 способа развертывания

Способ 1: Railway (самый простой — рекомендуется!)

Автоматическое развертывание через пуш в GitHub!

1. Пуш в GitHub

   cd global-papers-mcp
   git init && git add . && git commit -m "Initial commit"
   git remote add origin https://github.com/YOUR_USERNAME/global-papers-mcp.git
   git push -u origin main

2. Подключение к Railway

   • Перейдите на https://railway.app

   • Sign in with GitHub

   • New Project → Deploy from GitHub repo

   • Выберите global-papers-mcp → Deploy Now

3. Проверка домена

   • Settings → Networking → Generate Domain

   • Скопируйте URL: https://xxx.up.railway.app/mcp

4. Подключение к Claude.ai

   • Settings → Connectors → Add Connector

   • Вставьте URL → Сохранить

Готово! 🎉

Подробное руководство: RAILWAY_DEPLOY.md

Способ 2: Fly.io (для продвинутых пользователей)

Скрипт автоматического развертывания:

# Mac/Linux
./deploy.sh

# Windows
deploy.bat

Подробное руководство: ONE_CLICK_DEPLOY.md

Related MCP server: Crossref Academic MCP Server

📋 Содержание

• Краткий обзор

• Обзор

• Основные функции

• Установка и запуск

  • Локальный запуск

  • Развертывание на Fly.io

• Регистрация коннектора Claude MCP

  • Способ 1: Claude.ai (веб/мобильное приложение) (рекомендуется)

  • Способ 2: Приложение Claude Desktop

  • Проверка подключения и тестирование

  • Устранение неполадок

• Настройка API-ключей

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

• Технологический стек

• Ограничения скорости (Rate Limits)

• Похожие проекты

• Лицензия

• Вклад

• Контакты

🎯 Краткий обзор

MCP-сервер для поиска по более чем 500 миллионам научных статей в Claude.ai

• 🔍 Интеграция 4 API — OpenAlex, Semantic Scholar, CrossRef, arXiv

• 🛠 13 инструментов — поиск, детальная информация, отслеживание цитирований, данные об авторах/организациях

• 🚀 Развертывание за 5 минут — быстрый отклик через регион Fly.io Tokyo

• 📚 Полная документация — 11 руководств

• ✅ API-ключи почти не нужны — OpenAlex, CrossRef и arXiv работают сразу

Обзор

Это MCP-сервер (Model Context Protocol), позволяющий искать и анализировать зарубежные научные статьи в Claude.ai. Он объединяет 4 основных научных API для обеспечения комплексного поиска.

Поддерживаемые API

1. OpenAlex — более 250 млн статей во всех областях

2. Semantic Scholar — более 200 млн статей, специализация на AI/ML

3. CrossRef — более 150 млн метаданных на основе DOI

4. arXiv — 2,4 млн препринтов по физике, математике и CS

Основные функции

Инструменты OpenAlex (4)

• openalex_search_papers — поиск статей

• openalex_get_paper_detail — детальная информация о статье

• openalex_get_author — информация об авторе

• openalex_search_institutions — поиск организаций

Инструменты Semantic Scholar (4)

• semantic_search_papers — поиск статей

• semantic_get_paper_detail — детальная информация о статье

• semantic_get_citations — просмотр цитирований

• semantic_get_references — просмотр списка литературы

Инструменты CrossRef (3)

• crossref_search_works — поиск статей

• crossref_get_work_by_doi — поиск статьи по DOI

• crossref_search_journals — поиск журналов

Инструменты arXiv (2)

• arxiv_search_papers — поиск статей

• arxiv_get_paper_detail — детальная информация о статье

Установка и запуск

Локальный запуск

# 1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/global-papers-mcp.git
cd global-papers-mcp

# 2. 의존성 설치
pip install -r requirements.txt

# 3. 환경 변수 설정 (선택)
cp .env.example .env
# .env 파일에서 SEMANTIC_SCHOLAR_API_KEY 설정 (선택사항)

# 4. 로컬 테스트 실행
python server.py

Развертывание на Fly.io

# 1. Fly.io CLI 설치
curl -L https://fly.io/install.sh | sh

# 2. Fly.io 로그인
flyctl auth login

# 3. 앱 생성 (도쿄 리전 사용으로 latency 최소화)
flyctl launch --no-deploy

# 4. 리전을 Tokyo(nrt)로 변경
flyctl regions set nrt

# 5. 배포
flyctl deploy

# 6. API 키 설정 (Semantic Scholar 사용 시)
flyctl secrets set SEMANTIC_SCHOLAR_API_KEY=your_api_key_here

# 7. MCP URL 확인
flyctl info
# URL 예시: https://global-papers-mcp.fly.dev/mcp

Регистрация коннектора Claude MCP

🌐 Способ 1: Claude.ai (веб/мобильное приложение) (рекомендуется)

Самый простой и быстрый способ!

Шаг 1: Развертывание MCP-сервера и получение URL

Сначала завершите развертывание на Fly.io (см. Развертывание на Fly.io выше)

# 배포 후 MCP URL 확인
flyctl info

Пример вывода:

Hostname = global-papers-mcp.fly.dev

MCP URL: https://global-papers-mcp.fly.dev/mcp (обязательно добавьте /mcp в конце!)

Шаг 2: Переход в Claude.ai

Откройте https://claude.ai в браузере (или запустите мобильное приложение)

Шаг 3: Открытие меню настроек

Веб (десктоп):

• Нажмите на иконку профиля (или свое имя) в левом нижнем углу

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

Мобильное приложение (iOS/Android):

• Нажмите кнопку меню (≡) в правом верхнем углу

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

Шаг 4: Переход к меню коннекторов

• Нажмите на меню Connectors или Integrations

• Либо выберите Features → Model Context Protocol

Шаг 5: Добавление нового коннектора

Нажмите кнопку Add Connector или + Add

Шаг 6: Ввод данных MCP

Введите следующую информацию:

⚠️ Важно: в конце URL обязательно должно быть /mcp!

Пример:

• ✅ Правильный URL: https://global-papers-mcp.fly.dev/mcp

• ❌ Неправильный URL: https://global-papers-mcp.fly.dev

Шаг 7: Сохранение и подключение

• Нажмите кнопку Connect или Save

• Произойдет автоматическая проверка подключения

• Убедитесь, что статус изменился на "Connected" или "Active"

Шаг 8: Проверка подключения и тестирование

Проверка в списке коннекторов:

• Global Papers MCP должен появиться в списке

• Статус: 🟢 Connected

Тестирование:

Начните новый чат и введите следующую команду:

"OpenAlex에서 machine learning 관련 논문 5개 검색해줘"

Если Claude вернет результаты поиска статей — все прошло успешно! 🎉

💻 Способ 2: Приложение Claude Desktop

Если вы используете приложение Claude Desktop на локальном ПК

Вариант A: Использование URL развертывания Fly.io (рекомендуется)

1. Найдите файл конфигурации

   Пути в зависимости от ОС:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/claude/claude_desktop_config.json

2. Откройте файл конфигурации

   Mac/Linux:

   # 파일이 없으면 생성
   mkdir -p ~/Library/Application\ Support/Claude/
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Windows:

   notepad %APPDATA%\Claude\claude_desktop_config.json

3. Добавьте MCP-сервер

   Введите следующее или добавьте в существующий файл:

   {
     "mcpServers": {
       "global-papers": {
         "url": "https://global-papers-mcp.fly.dev/mcp"
       }
     }
   }

   Если вы используете несколько MCP-серверов:

   {
     "mcpServers": {
       "global-papers": {
         "url": "https://global-papers-mcp.fly.dev/mcp"
       },
       "kci-papers": {
         "url": "https://kci-mcp-korea.fly.dev/mcp"
       }
     }
   }

4. Сохраните файл и перезапустите Claude Desktop

   • Сохраните файл (Ctrl+S или Cmd+S)

   • Полностью закройте приложение Claude Desktop

   • Запустите Claude Desktop снова

5. Проверка подключения

   После начала нового чата в Claude Desktop:

   "사용 가능한 도구를 보여줘"

   Если инструменты Global Papers MCP отображаются — все успешно!

Вариант B: Локальный запуск сервера

Если вы запускаете сервер только локально без Fly.io

1. Подготовка к запуску локального сервера

   cd /path/to/global-papers-mcp
   pip install -r requirements.txt

2. Редактирование файла конфигурации

   claude_desktop_config.json:

   {
     "mcpServers": {
       "global-papers": {
         "command": "python",
         "args": ["/absolute/path/to/global-papers-mcp/server.py"]
       }
     }
   }

   ⚠️ Внимание:

   • Путь должен быть абсолютным

   • Windows: C:\\Users\\YourName\\global-papers-mcp\\server.py

   • Mac/Linux: /Users/YourName/global-papers-mcp/server.py

3. Перезапуск Claude Desktop

   После сохранения файла перезапустите приложение

4. Автоматический запуск сервера

   Локальный сервер будет запускаться автоматически при запуске Claude Desktop.

🔍 Проверка подключения и тестирование

Проверка статуса

Claude.ai (веб/мобильное приложение):

1. Settings → Connectors

2. Проверьте статус Global Papers

   • 🟢 Connected = нормально

   • 🔴 Disconnected = ошибка

Claude Desktop:

1. Начните новый чат

2. Введите команду:

   "연결된 MCP 서버를 보여줘"

Тестирование функций

Базовый поиск:

"OpenAlex에서 transformer architecture 관련 논문 5개 검색해줘"

Поиск по DOI:

"CrossRef에서 이 DOI의 논문을 조회해줘: 10.1038/s41586-021-03819-2"

Поиск в arXiv:

"arXiv에서 cs.AI 카테고리의 최신 논문 10개 보여줘"

Отслеживание цитирований:

"Semantic Scholar에서 'Attention is All You Need' 논문을 검색하고, 이 논문을 인용한 주요 논문들을 찾아줘"

⚠️ Устранение неполадок

Ошибка "Connection failed"

Причина 1: Ошибка в URL

• Отсутствует эндпоинт /mcp

• Решение: добавьте /mcp в конце URL

Причина 2: Сервер не запущен

# Fly.io 서버 상태 확인
flyctl status

# 서버가 중지되어 있으면
flyctl apps restart

Причина 3: Блокировка брандмауэром

• Сеть компании/университета может блокировать Fly.io

• Решение: попробуйте другую сеть или обратитесь в IT-отдел

Инструменты не отображаются

Claude.ai:

1. Обновите страницу браузера

2. Выйдите из системы и войдите снова

3. Попробуйте другой браузер

Claude Desktop:

1. Проверьте путь к файлу конфигурации

2. Проверьте синтаксис JSON (проверьте через JSONLint)

3. Полностью закройте приложение и перезапустите

Медленный отклик

Причина: Проблема с регионом

# 현재 리전 확인
flyctl regions list

# Tokyo(nrt) 리전으로 변경
flyctl regions set nrt
flyctl deploy

📚 Дополнительная помощь

• Подробное руководство: DEPLOYMENT.md

• Устранение неполадок: TROUBLESHOOTING.md

• Примеры использования: EXAMPLES.md

• FAQ: FAQ.md

Настройка API-ключей

Большинство API можно использовать без ключей, однако использование API-ключа для Semantic Scholar снимает ограничения по скорости (rate limit).

Получение API-ключа Semantic Scholar

1. Посетите https://www.semanticscholar.org/product/api

2. Нажмите "Get API Key" для получения бесплатного ключа

3. Установите его в файле .env или в переменных окружения

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

Используйте в Claude.ai следующим образом:

"transformer 아키텍처 관련 최신 논문을 OpenAlex에서 검색해줘"

"이 DOI의 논문을 CrossRef에서 조회해줘: 10.1038/nature12345"

"arXiv에서 quantum computing 관련 최신 프리프린트 찾아줘"

"Semantic Scholar에서 이 논문을 인용한 논문들을 찾아줘"

Технологический стек

• FastMCP — фреймворк для MCP-серверов

• httpx — асинхронный HTTP-клиент

• Python 3.9+

• Fly.io — платформа для развертывания (регион Tokyo)

Ограничения скорости (Rate Limits)

• OpenAlex: 100 000 запросов/день (API-ключ не нужен)

• Semantic Scholar: 100 запросов/5 минут без ключа, лимиты выше при использовании ключа

• CrossRef: более быстрый отклик при использовании polite pool

• arXiv: рекомендуется 1 запрос/3 секунды

Похожие проекты

• kci-mcp-korea — MCP-сервер для индекса цитирования корейских научных журналов (KCI)

Лицензия

MIT License

Вклад

Ишью и PR приветствуются!

Контакты

• GitHub Issues: https://github.com/YOUR_USERNAME/global-papers-mcp/issues