Microsoft Graph API知识搜索工具

一个提供Microsoft Graph API知识的MCP服务器,可搜索27000多个端点、查找权限并获取代码示例。

  • by UniverseCitiz3n
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 UniverseCitiz3n/msgraph-kb-mcp

使用说明

msgraph-kb-mcp

A. 模型上下文协议(MCP) 提供以下功能的服务器 Microsoft Graph API知识 --搜索27000多个端点,查找权限,并获取代码示例,所有这些都可以从您的AI助手中完成。

快速开始

无需本地安装。使用 npx 按需运行服务器:

npx github:UniverseCitiz3n/msgraph-kb-mcp

先决条件: Node.js≥18 git 在PATH环境变量中可用。


在MCP客户端中安装

VS代码(GitHub副本)

一键安装:

平台 VS代码 VS代码内部人员
macOS/Linux
视窗

或手动添加到 .vscode/mcp.json 在您的工作区中(如果文件不存在,请创建该文件):

{
  "servers": {
    "msgraph-kb": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:UniverseCitiz3n/msgraph-kb-mcp"]
    }
  }
}

克劳德桌面版

编辑您的Claude Desktop配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "msgraph-kb": {
      "command": "npx",
      "args": ["-y", "github:UniverseCitiz3n/msgraph-kb-mcp"]
    }
  }
}

克劳德代码

添加到您的项目 mcp.json 文件:

{
  "mcpServers": {
    "msgraph-kb": {
      "command": "npx",
      "args": ["-y", "github:UniverseCitiz3n/msgraph-kb-mcp"]
    }
  }
}

GitHub Copilot编码代理(存储库设置)

在您的存储库中 设置→ 副驾驶→ MCP服务器,添加:

{
  "mcpServers": {
    "msgraph-kb": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "github:UniverseCitiz3n/msgraph-kb-mcp"],
      "tools": ["*"]
    }
  }
}

可用工具

工具 输入 描述
search_graph_apis query (string) 按关键字搜索端点--返回路径、方法、描述、权限
get_api_details endpoint (string) 特定端点的完整详细信息
get_api_sample endpoint (string) 端点的代码示例
list_permissions endpoint (string) 委托和应用程序权限
get_server_info (无) 数据版本、克隆时间戳、索引统计信息

端点建议

服务器可以连接 advisories 当已知的真实世界行为与索引元数据不同时,将结果转换为端点。

当前咨询:

  • Intune DeviceConfigV2警告 PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicy-id}/settings/{deviceManagementConfigurationSetting-id}.
  • 如果此路由在您的租户中返回路由不匹配错误,请首选:
    • PUT /deviceManagement/configurationPolicies('{deviceManagementConfigurationPolicy-id}')
    • 包含完整的策略有效负载,并嵌入 settings.

这些建议是附加指南,不能取代官方的Graph文档。


本地开发

克隆仓库,安装依赖项,然后构建:

git clone https://github.com/UniverseCitiz3n/msgraph-kb-mcp.git
cd msgraph-kb-mcp
npm install
npm run build
node dist/index.js

将任何MCP客户端指向构建的二进制文件:

{
  "mcpServers": {
    "msgraph-kb": {
      "command": "node",
      "args": ["/absolute/path/to/msgraph-kb-mcp/dist/index.js"]
    }
  }
}

运作原理

启动时,服务器获取最新版本的 merill/msgraph 并从以下文件构建可搜索的内存索引 skills/msgraph/references/:

  • graph-api-index.json --端点路径、HTTP方法、摘要
  • api-docs-index.json --权限、注释、查询参数
  • samples-index.json --示例查询

克隆存储在临时目录中,并在进程退出时删除。如果克隆失败,服务器仍将启动——工具将返回一个描述性错误,直到数据可用。

搜索相关性

  • 查询被规范化以删除停用词、对术语进行去复数化并修复常见的拼写错误(例如, bussines → business).
  • Windows Update for Business驱动程序配置文件路由(包括驱动程序清单)获得了额外的相关性提升,因此自然语言提示在不粘贴原始URL的情况下显示正确的端点。

许可证

麻省理工学院