Naver Remote MCP

Naver远程MCP

通过NAVER OAuth认证，集成了NAVER搜索和NAVER日历日程添加功能的MCP服务器。\ 连接MCP服务器后，会自动重定向到NAVER登录页面。通过登录和授权，您可以在代理上进行NAVER Web搜索和添加个性化的NAVER日历日程。

🎯 工具列表

• get_current_time：返回当前时间的工具。以韩国时间（KST，UTC+9）为基准提供当前日期和时间。
• web_search：执行NAVER Web搜索的工具。
• create_calendar_schedule：在NAVER日历中添加新日程的工具。

🛠️ 技术堆栈

• FastMCP、Starlette、httpx
• NAVER OAuth 2.0
• API CLOVA工作室

📦 安装

# 의존성 설치
pip install requirements.txt

# .env 파일 생성
NAVER_CLIENT_ID=your_client_id
NAVER_CLIENT_SECRET=your_client_secret
BASE_URL=https://your-ngrok-url
CLOVA_STUDIO_API_KEY=your_clova_studio_api_key

🚀 执行

运行FastMCP服务器

python remote_auth_server.py

运行FastMCP客户端

python fastmcp_client.py

ngrok设置（同时在其他终端上）：

ngrok http 8000

📋 NAVER Developers设置

1.创建应用程序并设置首选项

• https://developers.naver.com/连接
• 应用程序注册→设置应用程序名称
• 在使用的API中添加“搜索”、“NAVER登录”、“日历”
• 在登录开放API服务环境中选择“PC Web”
• 将颁发的客户端ID另存为NAVER_CLIENT_ID

2.NAVER登录设置

• 登录开放API服务环境>输入服务URL
• 예: https://your-ngrok-url
• 注册NAVER登录Callback URL
• 예: https://your-ngrok-url/auth/callback

3.客户端秘密设置

• 在应用程序设置中检查客户端机密
• 将颁发的密钥保存到NAVER_CLIENT_SECRET

4.设置非登录开放API

• 非登录开放API服务环境>输入服务URL
• 예: https://your-ngrok-url

5.测试注册（必需）

• 在“成员管理”选项卡上注册要测试的NAVER ID
• 如果应用程序处于“正在开发”状态，则只能登录已注册的ID

6.（可选）公开应用程序

• 开发完成后可以将应用程序更改为公共状态

💡 使用方法

1.MCP客户端设置

运行FastMCP服务器后，将以下内容添加到MCP客户端的配置文件中，如Claude Desktop：

{
  "mcpServers": {
    "naver-remote-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-ngrok-url/mcp"]
    }
  }
}

2.基本流程

搜索地点后将日历添加到日历： “帮我搜索艺术殿堂的地址，明天下午3点帮我添加访问日程。请在日程上记下地址。”

• web_search（“艺术殿堂地址”）→搜索场所信息

• get_current_time（）->返回当前日期和时间

• create_calendar_schedule（title=“…”，description=“内容”）→根据当前时间将日历添加到要添加的日期

🏗️ 技术结构

naver.py

NaverTokenVerifier：验证NAVER OAuth令牌

• 调用用户配置文件API（/v1/nid/me）验证令牌
• 提取和验证用户信息

Naver提供器：继承OAuthProxy，实现NAVER OAuth

• OIDC API：PKCE（代码交换的验证密钥）지원
• 支持NAVER的client_secret_post认证方式
• 令牌存储/续订管理
• 提取用户信息

remote_auth_server.py

MCP服务器 （基于FastMCP）

• 3개 도구:send_message_to_me、send_message、search_naver_friends

fastmcp_client.py

FastMCP OAuth支持的客户端

• 适用于OAuth的fastmcp服务器的兼容fastmcp客户端
• 利用NAVER的HCX-005型号

______________________________________________________________________

⚙ENT主要特点

✅ 轻松连接OAuth：实现NAVER的标准OAuth 2.0\ ✅ 长文信息支持：以200个字符以上的链接显示Web\ ✅ 响应式HTML：优化移动/桌面\ ✅ 管理环境变量令牌：登录后自动保存/使用令牌\ ✅ CLOVA Studio集成：可以使用NAVER的AI模型