书写辅助MCP-AI检查器
一个集成了MCP（模型上下文协议）的智能文本分析工具，用于检测人工智能生成的内容。
🚀 特性
- 前端用户界面：简洁、现代的文本分析界面
- 后端API：具有多个端点的基于Flask的服务器
- MCP集成：支持模型上下文协议客户端
- Finchat API：可选择与Finchat AI服务集成
- 局部分析：当API不可用时，基于启发式的回退
- 实时分析：对文本真实性的即时反馈
📋 先决条件
- Python 3.8或更高版本
- 现代网络浏览器（Chrome、Firefox、Safari、Edge）
- Git（用于开发）
🔧 安装
- 克隆存储库:
git clone https://github.com/MikeVenge/write-aid-mcp.git
cd write-aid-mcp- 安装依赖项:
pip3 install -r requirements.txt- 配置（可选）:
- 编辑 ai_checker_config.js 用于前端设置 - 为Finchat API设置环境变量（见下文）
🎯 快速开始
选项1：使用后端运行（推荐）
./start_with_backend.sh这将：
- 在端口5001上启动后端服务器
- 在端口8000上启动前端服务器
- 在浏览器中打开应用程序
选项2：分别运行后端和前端
终端1-后端:
python3 backend_server.py2号航站楼-前端:
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📚 文档
- RUN_INSTRUCTIONS.md -详细的运行说明
- BACKEND_SETUP.md -后端配置指南
- QUICK_SETUP.md -快速参考指南
- 故障排除.md -常见问题和解决方案
- MCP_INTEGRATION-GUIDE.md -MCP协议详细信息
🔍 运作原理
- 用户输入：将文本粘贴到web界面中
- 分析：文本分析方式：
- Finchat API（如果配置） - 局部启发式算法（回退）
- 结果：显示置信度评分和详细分析
- 反馈：人工智能与人工书写内容的视觉指标
🛠️ API终点
后端服务器（端口5001）
GET /health-服务器健康检查POST /analyze-分析AI内容的文本POST /mcp/analyze-MCP兼容分析终点
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件
👤 作者
Mike Venge
- github： @MikeVenge
- 存储库： 书写辅助mcp
🐛 问题
发现bug了吗？请打开一个问题
⭐ 支持
如果你觉得这个项目有用，请在GitHub上给它一颗星！
______________________________________________________________________
版本: 1.0.0\ 最后更新：2025年11月10日