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 网页端直接使用（无需安装，最简单）

无需安装任何程序，只需输入一个地址即可。

⚠️ 需要 Claude Pro / Max / Team / Enterprise 订阅（免费版仅支持 1 个连接器）

添加连接器的方法：

1. 登录 claude.ai。

2. 点击左侧边栏底部的个人名称。

3. 选择 “设置” (Settings)。

4. 进入 “连接器” (Connectors) 菜单。

5. 点击 “添加自定义连接器” 按钮。

6. 输入以下内容：

   • 名称: kci-mcp (可自定义)

   • 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 路径中的反斜杠需要双写：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