Skip to main content
Glama
Sign In
deenesjakoruzh
.KCI MCP Server (한국학술지인용색인)

.KCI MCP Server (한국학술지인용색인)

by auraweon7-ship-it
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

KCI MCPサーバー

MCP Compatible TypeScript License: MIT

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_キー>

  1. 保存後、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設定

以下のパスの設定ファイルを開きます:

OS

パス

Windows

%APPDATA%\Claude\claude_desktop_config.json

Mac

~/Library/Application Support/Claude/claude_desktop_config.json

💡 ショートカット: 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_키>"
      }
    }
  }
}

✅ インストール確認

クライアント

確認方法

claude.aiウェブ

チャット画面下部 + → Connectorsでkci-mcpが有効か確認

Claude Desktop

入力欄下部 🔨 アイコンをクリック → ツールリストに kci_search_articles など7つ表示されるか確認

Claude Code

ターミナルで claude mcp list を実行

🛠️ ツールリスト (7つ)

ツール

説明

主なパラメータ

kci_search_articles

論文基本検索

title, author, journal, keyword, dateFrom, dateTo

kci_article_detail

論文詳細照会

id (ART番号)

kci_search_references

参考文献検索

title, author, pubiYr

kci_get_citations

引用指数リスト

year, years (2-5)

kci_citation_detail

学術誌IF詳細

id (SER番号)

kci_search_by_author

著者別論文検索

author, affiliation, dateFrom, dateTo

kci_search_by_keyword

キーワード論文検索

keyword, journal, dateFrom, dateTo

💬 使用例プロンプト

# 논문 검색
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_API_KEY

O

(直接入力必須)

KCI Open API認証キー — 発行

PORT

X

3001

HTTPサーバーポート

CORS_ORIGIN

X

*

CORS許可オリジン

TRANSPORT

X

stdio

http または stdio

📚 KCI Open API情報

項目

値

公式エンドポイント

https://open.kci.go.kr/po/openapi/openApiSearch.kci

レスポンス形式

XML (UTF-8, MetaDataルート)

API種類

articleSearch / articleDetail / referenceSearch / citation / citationDetail

KCIポータル

https://www.kci.go.kr/kciportal/main.kci

🐳 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors