README
🚀 lgpd - mcp
lgpd - mcp是一个MCP(Model Context Protocol)服务器,旨在协助组织和开发者遵守《通用数据保护法》(Lei Geral de Proteção de Dados Pessoais,LGPD - 第13.709/2018号法律)。
✨ 主要特性
- 9种工具:用于合法依据验证、同意书管理、文档模板、隐私影响评估(PIA)、检查清单、政策制定、数据主体权利管理、敏感数据映射以及风险评估。
- 5种参考资源:涵盖基础知识、法律条文、合法依据、术语表以及国家数据保护局(ANPD)相关信息。
- 4种提示模板:用于政策审查、数据主体回复、场景评估和文档记录。
📦 安装指南
通过npm(推荐)
npx @lordmendes/lgpd-mcp
或者全局安装:
npm install -g @lordmendes/lgpd-mcp
lgpd-mcp
通过仓库安装
git clone https://github.com/LordMendes/lgpd-mcp.git
cd lgpd-mcp
# 安装依赖
pnpm install
# 或者:npm install
# 或者:yarn install
# 编译项目(生产环境必需)
pnpm build
💻 使用示例
标准输入输出模式(默认)
服务器通过标准输入输出运行,并等待MCP客户端(如Cursor、Claude Desktop等)的连接:
# 如果通过npm安装
npx @lordmendes/lgpd-mcp
# 本地开发
npx tsx src/index.ts
HTTP模式(远程)
以HTTP服务器模式运行(用于远程使用):
pnpm start:http
# 或者:npx tsx src/http.ts
HTTP服务器监听由MCP_PORT定义的端口(默认:3000)。端点为:POST /mcp。详情请参考 docs/HTTP.md。
使用MCP Inspector进行测试
pnpm test:mcp
# 或者:npx @modelcontextprotocol/inspector npx tsx src/index.ts
📚 详细文档
配置相关
- Cursor配置:查看在Cursor中详细的配置说明。
- Claude Desktop配置:查看在Claude Desktop中的配置说明。
环境变量
| 属性 | 详情 |
| ---- | ---- |
| MCP_PORT | HTTP服务器端口(远程模式) | 3000 |
参考 .env.example 文件。
其他文档
- 发布说明 — 如何在npm和MCP Registry上发布。
- 工具说明 — 每个工具的详细描述。
- 资源说明 — 每个资源的详细描述。
- 提示模板说明 — 每个提示模板的详细描述。
- HTTP传输 — 远程HTTP使用方法。
- 法律声明 — 本工具不替代专业法律建议。
- 安全说明 — 项目的安全实践。
🔧 脚本说明
| 脚本 | 描述 |
| ---- | ---- |
| pnpm dev | 在开发模式下运行服务器 |
| pnpm start | 运行已编译的服务器 |
| pnpm build | 编译TypeScript代码 |
| pnpm test | 运行单元测试 |
| pnpm lint | 使用ESLint检查代码 |
| pnpm format | 使用Prettier格式化代码 |
⚠️ 重要提示
所有工具仅起辅助作用,不能替代专业的法律建议。在做出法律决策时,请始终咨询律师或数据保护顾问。如需官方指导,请访问 国家数据保护局(ANPD)。
📄 许可证
本项目采用MIT许可证。
微信扫一扫