OneDrive MCP Server
2025.04.20
0
Java文件管理文件管理
OneDrive MCP Server 是一个基于 Spring Boot 和 Spring AI 的 Model Context Protocol (MCP) 服务器实现，旨在使 AI 代理能够搜索和导航 Microsoft OneDrive 中的文件和文件夹。它提供了与 OneDrive 交互的 MCP 兼容接口，支持文件搜索、文件夹导航、获取文件和文件夹的直接 web URL 等功能。
View on GitHub
Overview
基本能力
产品定位
OneDrive MCP Server 是一个连接 AI 代理与 Microsoft OneDrive 的中间件，提供文件管理和导航功能。
核心功能
- 🔍 在 OneDrive 中搜索文件，支持文件夹过滤
- 📁 搜索和导航文件夹结构
- 🔗 获取文件和文件夹的直接 web URL
- 🤖 MCP 兼容接口，便于 AI 代理集成
- 🔒 使用 Microsoft Graph API 进行安全访问
适用场景
- AI 代理需要访问和管理 OneDrive 文件
- 开发需要集成 OneDrive 文件搜索和导航功能的应用程序
- 需要自动化处理 OneDrive 文件的场景
工具列表
- Search Files: 在 OneDrive 中搜索文件，支持文件夹过滤
- Search Folders: 导航和搜索文件夹结构
- List Folder Contents: 列出特定文件夹路径下的所有文件和文件夹
常见问题解答
- 如何获取 Microsoft OneDrive 访问令牌？
- 可以使用 Microsoft Graph Explorer 快速获取临时令牌
- 或者注册自己的应用程序获取长期有效的令牌
- 如何配置 MCP 服务器？
- 可以通过环境变量
MICROSOFT_ONEDRIVE_ACCESS_TOKEN设置访问令牌 - 支持本地 JAR 文件和 Docker 容器两种运行方式
使用教程
使用依赖
- Java 21 或更高版本
- Maven 3.6+
- Docker (可选，用于容器化部署)
- Microsoft OneDrive 账户和访问令牌
安装教程
- 克隆项目并构建:
mvn clean package
- 运行服务器:
java -jar target/onedrive-mcp-server-0.0.1.jar
或者使用 Docker:
mvn spring-boot:build-image
docker run -p 8080:8080 -e ONEDRIVE_ACCESS_TOKEN=your-token karthik20/onedrive-mcp-server:0.0.1
调试方式
- 运行测试套件:
mvn test
- 配置 VS Code MCP 服务器:
- 创建或更新
.vscode/mcp.json文件 - 配置本地 JAR 或 Docker 运行方式
-
设置访问令牌
-
测试与 MCP 客户端的集成:
- GitHub Copilot
- Claude Desktop