AI文本检测工具

一款集成了MCP协议的智能文本分析工具,用于检测AI生成内容,适用于内容审核、学术诚信检查等场景。

  • by MikeVenge
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 MikeVenge/write-aid-mcp

使用说明

书写辅助MCP-AI检查器

一个集成了MCP(模型上下文协议)的智能文本分析工具,用于检测人工智能生成的内容。

🚀 特性

  • 前端用户界面:简洁、现代的文本分析界面
  • 后端API:具有多个端点的基于Flask的服务器
  • MCP集成:支持模型上下文协议客户端
  • Finchat API:可选择与Finchat AI服务集成
  • 局部分析:当API不可用时,基于启发式的回退
  • 实时分析:对文本真实性的即时反馈

📋 先决条件

  • Python 3.8或更高版本
  • 现代网络浏览器(Chrome、Firefox、Safari、Edge)
  • Git(用于开发)

🔧 安装

  1. 克隆存储库:

    git clone https://github.com/MikeVenge/write-aid-mcp.git
    cd write-aid-mcp
    
  2. 安装依赖项:

    pip3 install -r requirements.txt
    
  3. 配置(可选):

    • 编辑 ai_checker_config.js 用于前端设置
    • 为Finchat API设置环境变量(见下文)

🎯 快速开始

选项1:使用后端运行(推荐)

./start_with_backend.sh

这将:

  • 在端口5001上启动后端服务器
  • 在端口8000上启动前端服务器
  • 在浏览器中打开应用程序

选项2:分别运行后端和前端

终端1-后端:

python3 backend_server.py

2号航站楼-前端:

python3 -m http.server 8000

浏览器:

http://localhost:8000/ai_checker.html

🔐 Finchat API配置(可选)

要使用Finchat API集成,请设置以下环境变量:

export FINCHAT_BASE_URL="https://your-finchat-instance.com"
export FINCHAT_API_TOKEN="your_jwt_token_here"
export FINCHAT_COT_SLUG="ai-detector"
export FINCHAT_MODEL="gemini-2.5-flash"

看 QUICK_SETUP.md 详细配置。

📁 项目结构

write-aid-mcp/
├── ai_checker.html          # Main frontend interface
├── ai_checker.js            # Frontend JavaScript logic
├── ai_checker.css           # Styling
├── ai_checker_config.js     # Frontend configuration
├── backend_server.py        # Flask backend server
├── mcp_*.py                 # MCP client implementations
├── requirements.txt         # Python dependencies
├── start_with_backend.sh    # Startup script
└── docs/                    # Documentation files

🧪 测试

运行测试套件:

python3 test_ai_detector.py

📚 文档

🔍 运作原理

  1. 用户输入:将文本粘贴到web界面中
  2. 分析:文本分析方式:
    • Finchat API(如果配置)
    • 局部启发式算法(回退)
  3. 结果:显示置信度评分和详细分析
  4. 反馈:人工智能与人工书写内容的视觉指标

🛠️ API终点

后端服务器(端口5001)

  • GET /health -服务器健康检查
  • POST /analyze -分析AI内容的文本
  • POST /mcp/analyze -MCP兼容分析终点

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📄 许可证

MIT许可证-有关详细信息,请参阅许可证文件

👤 作者

Mike Venge

🐛 问题

发现bug了吗?请打开一个问题 GitHub问题

⭐ 支持

如果你觉得这个项目有用,请在GitHub上给它一颗星!


版本: 1.0.0
最后更新:2025年11月10日