<中文翻译> 一笔记MCP

【技术文档摘要】： 从ZubeidHendricks/azure-onenote-mcp-server分叉而来，请参阅该页面以获取原始README.md

关于

这是一个针对OneNote的MCP。经过大量修改，现在支持个人笔记本。 更新至最新的MCP API。支持缓存凭证。

改进

功能性

• 通过实现ReadableStream修复了getPageContent功能
• 成功实现了针对个人笔记本的API调用
• 更新索引和工具以使用最新版的MCP

代码架构

• 通过移除不必要的类简化了代码库
• 移除了许多不必要的文件

认证与性能

• 实现了磁盘缓存认证凭证
• 更新了包依赖项
• 增加了dotenv支持，以便直接测试能力

Azure应用注册

1. 转到Azure门户并导航到应用注册
2. 创建一个新的OneNoteMCP注册
3. 添加Microsoft Graph API权限：
   • Notes.Read
   • Notes.Read.All
   • （可选添加Notes.Write权限，但存在丢失笔记的风险）
4. 创建客户端密钥
5. 复制客户端ID/密钥用于配置
6. 在清单中设置signInAudience为AzureADandPersonalMicrosoftAccount

MCP服务器设置

在本地的.env文件以及Claude桌面中放置客户端ID/密钥。

AUTH_CACHE_DIR应为生成的API访问令牌存储目录。

AZURE_CLIENT_ID=\
AZURE_CLIENT_SECRET=
AUTH_CACHE_DIR="C:\\git\\azure-onenote-mcp-server\\.cache"

首先手动运行服务器以生成将被缓存并在Claude桌面后续运行服务器时使用的凭证。

npm install
npm build
npm run

服务器启动并登录后，可以通过运行以下命令直接测试API是否工作。

{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "listNotebooks", "arguments": {}}}

Claude MCP配置

{
  "mcpServers": {
    "onenote": {
      "command": "node",
      "args": ["C:\\git\\azure-onenote-mcp-server\\dist\\index.js"],
      "env": {
        "AZURE_CLIENT_ID": "...",
        "AZURE_CLIENT_SECRET": "...",
        "AUTH_CACHE_DIR": "C:\\git\\azure-onenote-mcp-server\\.cache"
      }
    }
  }
}