KCI MCPサーバー

KCI(韓国学術誌引用索引) Open APIベースの学術論文検索・分析MCPサーバー

韓国研究財団のKCI Open APIを活用し、国内の学術論文検索、詳細照会、参考文献分析、引用指数照会をClaude AIと統合します。

✨ 主な特徴

• 7つのツール: 論文検索・詳細・参考文献・引用指数・著者検索・キーワード検索を完全サポート

• 公式API準拠: open.kci.go.kr 公式エンドポイントおよびMetaData XML構造を使用

• KCI 5種API: articleSearch / articleDetail / referenceSearch / citation / citationDetail

• STDIO + HTTP: ローカル(Claude Desktop)およびリモートデプロイの両方をサポート

• TypeScript: 完全な型安全性と構造化されたレスポンス

🚀 インストールおよび使用方法

方法1: Claude.aiウェブで直接使用（インストール不要、最も簡単）

何もインストールせず、アドレスを1つ入力するだけです。

⚠️ Claude Pro / Max / Team / Enterprise プランが必要（Freeプランはコネクタ1つのみ可能）

コネクタの追加方法:

1. claude.aiにログインします。

2. 左サイドバー下部の自分の名前をクリックします。

3. 「設定」 (Settings)を選択します。

4. 「コネクタ」 (Connectors)メニューに入ります。

5. **「カスタムコネクタを追加」**ボタンをクリックします。

6. 以下の内容を入力します:

   • 名前: kci-mcp (好きな名前でOK)

   • URL: 下記アドレスの YOUR_KCI_API_KEY 部分をご自身のKCI API認証キーに書き換えて入力してください:

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

💡 KCI APIキーの発行: 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のパスはバックスラッシュを2回書く必要があります: C:\Users\ユーザー名\kci-mcp\dist\index.js

💡 KCI APIキーの発行: 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

🏫 韓国外国語大学校 中国学大学 中国言語文化学部
    Division of Chinese Language, Literature and Culture
    Hankuk University of Foreign Studies

🏛️ 国家教育委員会 AI特別委員会委員
📋 教育部 AI人材養成推進団

🌐 K-AI教育ネットワーク: https://k-ai.it.kr/
📧 auraweon7@gmail.com
📱 APP: kletter.kr / kteacher.kr