🚀 《CISA 25-01网络安全审计法案》MCP服务器配置文档
本项目提供的MCP服务器实现，主要用于支持《CISA 25-01网络安全审计法案》。该法案要求联邦民用行政部门和机构在其IT基础设施中实施特定网络安全措施。此文档将详细阐述如何配置和使用该MCP服务器。
🚀 快速开始
本文档涵盖了MCP服务器的安装、配置、使用、API接口参考、错误处理、测试方法、安全注意事项、贡献指南以及许可证协议等内容，助您快速上手。
✨ 主要特性
- 支持《CISA 25-01网络安全审计法案》的实施。
- 提供多种工具，可对网络安全策略进行灵活配置。
- 具备详细的API接口，方便进行二次开发。
📦 安装指南
克隆仓库
git clone https://github.com/DynamicEndpoints/BOD-25-01-CSA-MCP.git
cd cisa-m365
安装依赖
npm install
构建服务器
npm run build
💻 使用示例
基础用法
可用工具列表
- block_legacy_auth：阻止 legacy 认证方式。
{}
- block_high_risk_users：阻止高风险用户登录。
{}
- enforce_phishing_resistant_mfa：强制启用反钓鱼 MFA 功能。
{}
- configure_global_admins：配置 Global Administrator 角色分配。
{
"userIds": ["user1-id", "user2-id"]
}
- get_policy_status：获取所有安全策略的当前状态。
{}
在 Node.js 中使用示例
// 阻止 legacy 认证方式
const result = await client.callTool('block_legacy_auth', {});
// 获取策略状态
const status = await client.callTool('get_policy_status', {});
📚 详细文档
配置说明
创建Azure AD应用
- 登录 Azure Portal
- 进入 Azure Active Directory
- 注册一个新的应用程序
- 添加所需的API权限（如 "Directory.ReadWrite.All", "User.ReadWrite" 等）
- 创建一个应用程序密钥
配置环境变量
复制示例文件并编辑：
cp .env.example .env
修改 .env 文件内容：
TENANT_ID=your-tenant-id
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
配置MCP设置
创建或更新 MCP 配置文件：
{
"mcpServers": {
"cisa-m365": {
"command": "node",
"args": ["path/to/cisa-m365/build/index.js"],
"env": {
"TENANT_ID": "your-tenant-id",
"CLIENT_ID": "your-client-id",
"CLIENT_SECRET": "your-client-secret"
}
}
}
}
API接口参考
政策设置接口
interface PolicySettings {
老认证: {
禁止: boolean;
符合要求: boolean;
};
高风险用户: {
禁止: boolean;
符合要求: boolean;
};
mfa: {
反钓鱼MFA: boolean;
替代方式已启用: boolean;
符合要求: boolean;
};
应用程序: {
注册受限: boolean;
同意受限: boolean;
符合要求: boolean;
};
密码策略: {
禁止使用弱密码: boolean;
符合要求: boolean;
};
}
错误处理
错误代码示例
{
"error": {
"code": "INVALID_SYNTAX",
"message": "配置文件语法错误"
}
}
常见问题解答
- Q：如何排查MCP服务器启动失败的问题？
- A：检查日志文件，确认环境变量是否正确设置。
测试方法
单元测试
npm test
集成测试
- 启动 MCP 服务。
- 使用测试工具发送请求并验证响应。
🔧 技术细节
本项目围绕《CISA 25-01网络安全审计法案》展开，通过MCP服务器实现法案要求的网络安全措施。在技术实现上，借助Azure AD应用进行身份验证和权限管理，利用Node.js构建服务器，并通过配置环境变量和MCP设置文件来确保服务器的正常运行。同时，提供了丰富的工具和API接口，方便用户对网络安全策略进行灵活配置和管理。
📄 许可证
本项目遵循 MIT 协议，具体内容请参考 LICENSE 文件。
⚠️ 重要提示
- 确保所有敏感信息（如应用程序密钥）不以明文形式存储或传输。
- 定期更新依赖库，防范已知安全漏洞。
- 配置适当的安全策略和访问控制措施。
💡 使用建议
若您想为项目贡献代码，可按以下步骤操作：
- Fork 项目仓库。
- 创建功能分支并提交代码。
- 提交 Pull Request 并参与代码审查。