微信扫一扫article
README
🚀 快速MCP服务器用于Netwrix访问分析器
本项目是一个基于FastMCP的服务器，主要用于对Netwrix访问分析器的数据进行分析。同时，它与Claude Desktop集成，进一步增强了数据分析功能，为用户提供更强大、便捷的数据分析体验。
✨ 主要特性
- SQL Server集成：服务器启动时会自动连接SQL Server，实现无缝对接。
- 动态数据库架构探索：能够动态地对数据库架构进行探索，为数据分析提供便利。
- SQL查询执行：支持执行SQL查询，满足多样化的数据查询需求。
- Netwrix访问分析器文件系统工具：提供专门的文件系统工具，方便对Netwrix访问分析器的数据进行处理。
📦 安装指南
系统依赖项
首先，需要确保系统已安装ODBC SQL Server驱动程序，不同操作系统的安装方式如下：
- macOS：可使用Homebrew进行安装，命令为
brew install microsoft/mssql-release/msodbcsql17。 - Windows：从Microsoft ODBC驱动页面下载并安装。
- Linux：按照Microsoft的说明为您的发行版进行安装。
Python依赖项
使用uv安装所需的Python包。
数据库设置
此步骤仅用于开发或测试目的：
- 在项目目录中创建一个
.env文件，用于存储SQL Server连接信息，示例内容如下：
# 数据库连接信息
DB_SERVER=your_server_name
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password
DB_USE_WINDOWS_AUTH=FALSE # 设置为TRUE以使用Windows身份验证
- 将上述示例值替换为您实际的数据库连接信息。
依赖项说明
此MCP服务器需要以下依赖项：
- Python 3.12或更高版本
- MCP SDK
- pyodbc 4.0.39或更高版本（用于SQL Server连接）
- python-dotenv 1.0.0或更高版本（用于环境变量管理）
- ODBC驱动程序17 for SQL Server或更高版本（必须安装在系统上）
Netwrix访问分析器（NAA）依赖项
此MCP服务器需要Netwrix访问分析器（NAA）文件系统扫描已完成。
💻 使用示例
基础用法
在Claude Desktop的控制台中，您可以使用以下命令与新的Netwrix访问分析器MCP服务器进行交互：
# 获取所有正在运行的作业
Get-RunningJobs
# 检查用户对特定资源的访问权限
Get-ResourceAccess C:\files\project
🔧 技术细节
与Claude Desktop集成
要在Claude Desktop中使用此MCP服务器，可按以下步骤操作：
- 打开Claude Desktop。
- 转到“工具”菜单，选择“管理MCP服务器”。
- 在“新建”下拉菜单中选择“从文件添加”。
- 浏览并选择您刚刚创建的
.env文件。 - 点击“完成”将新的MCP服务器配置添加到Claude Desktop。
故障排除
连接问题
如果遇到连接问题，可按以下步骤进行排查：
- 验证SQL Server是否在运行且可以从网络访问。
- 检查
.env文件中的凭据是否正确。 - 确保ODBC驱动程序已正确安装。
- 查看日志以获取详细错误消息。
Claude Desktop集成
如果Claude Desktop找不到uv命令，可按以下步骤解决：
- 在配置中使用
uv的完整路径（使用which uv或where uv来找到它）。 - 确保在进行配置更改后重新启动了Claude Desktop。
- 检查Claude日志中是否有与MCP服务器相关的任何错误消息。