内容
# EN MOSTAFA AI AGENT
> 一个优先考虑Windows、支持阿拉伯语的本地代理运行时，它连接MCP客户端与浏览器自动化、文件、系统工具、短期记忆和实时操作员仪表盘。
[](https://www.python.org/)
[](https://modelcontextprotocol.io/)
[](https://playwright.dev/python/)
[](https://github.com/EN-MOSTAFA-AIAGENT/en-mostafa-ai-agent/actions/workflows/ci.yml)
[](LICENSE)
[](docs/DEVELOPMENT_STATUS.md)
**[阿拉伯语文档](README.ar.md)**
## 为什么存在这个项目
大多数桌面代理项目假设Unix环境、仅限英语的命令或托管执行后端。EN MOSTAFA AI AGENT探索了一条不同的路径：为Windows开发人员和操作员提供透明的本地运行时，支持阿拉伯语和英语命令，明确的安全和强力工具平面，可观察的浏览器会话和提供者中立的MCP连接。
该项目是为需要AI助手在真实机器上执行可验证工作的人员设计的，而不仅仅是生成指令，同时保持操作员对执行边界的控制。
## 提供的内容
- FastMCP网关，适用于Claude-compatible和其他MCP客户端。
- 本地Flask REST桥，用于文件系统和系统操作。
- Playwright浏览器自动化：导航、提取、交互、截图、渲染和轻量级UX分析。
- 阿拉伯语RTL仪表盘，包含实时状态、日志、截图和命令。
- 短期TTL内存和有限交互历史。
- 线程安全的作业，支持暂停、恢复、取消和等待用户状态。
- 常见浏览器操作的阿拉伯语和英语自然语言命令。
- Windows优先设置脚本，固定到Python 3.14。
- 安全的公共默认值：环回绑定和只读模式。
```mermaid
flowchart TD
A["Claude / Codex / MCP client"] --> B["FastMCP gateway :8000"]
B --> C["REST bridge :5001"]
B --> D["Playwright browser pool"]
B --> E["Short-term memory"]
C --> F["Windows files and shell"]
C --> G["Shared browser session"]
C --> H["Live RTL dashboard"]
```
## Windows快速入门
要求：Windows 10/11，Python 3.14和Git。
```powershell
git clone https://github.com/EN-MOSTAFA-AIAGENT/en-mostafa-ai-agent.git
cd en-mostafa-ai-agent
py -3.14 -m venv .venv
.\.venv\Scripts\Activate.ps1
py -3.14 -m pip install --upgrade pip
py -3.14 -m pip install -r requirements.txt
py -3.14 -m playwright install chromium
```
在单独的终端中启动REST桥和MCP网关：
```powershell
.\scripts\run_rest.ps1
.\scripts\run_mcp.ps1
```
然后打开：
- 健康检查：`http://127.0.0.1:5001/healthz`
- 操作员仪表盘：`http://127.0.0.1:5001/dashboard`
- MCP SSE端点：`http://127.0.0.1:8000/sse`
MCP客户端配置示例：
```json
{
"mcpServers": {
"en-mostafa-agent": {
"url": "http://127.0.0.1:8000/sse"
}
}
}
```
参见完整的[Windows安装指南](docs/INSTALLATION.md)和[功能参考](docs/CAPABILITIES.md)。
## 安全模型
此版本从以下内容开始：
```dotenv
REST_HOST=127.0.0.1
MCP_HOST=127.0.0.1
READONLY_MODE=true
```
强力工具可以修改文件并使用运行用户的权限执行shell命令。不要将端口5001或8000直接暴露给LAN或互联网。在启用写入或执行功能之前，请阅读[安全.md](SECURITY.md)。
## 现实世界验证
运行时从实际自动化工作增长而来，而不是合成代理演示。维护者运行的现场测试包括：
- `askmbt.com`上的网站检查：DOM提取、全页捕获、面向无障碍的UX检查和生成的本地报告。
- Live site工作流中的WordPress操作，结合浏览器检查和安全的本地执行。
- Dell Latitude系统上的Windows维护工作流：依赖项检查、更新编排、驱动程序验证和具有还原点意识的执行。
这些是维护者报告的验证，而不是生态系统采用指标。可复制的场景和当前的限制在[项目影响](docs/PROJECT_IMPACT.md)和[开发状态](docs/DEVELOPMENT_STATUS.md)中记录。
## 仓库映射
```text
src/ 可运行的MCP、REST、浏览器、内存和作业核心
experimental/ 提供的研究模块，等待缺少的内部适配器
wordpress-plugin/ 现有的WordPress REST、心跳和自愈适配器
chrome-extension/ 现有的浏览器桥和上下文自动化扩展
templates/ 现有的操作员仪表盘模板
root Python模块 已建立的2.x运行时和集成模块
docs/ 架构、功能、影响、安全性和路线图
scripts/ Windows设置和启动命令
tests/ 独立的核心和服务烟雾测试
.github/ CI和社区贡献模板
```
## 成熟度和范围
这是**公共预览**，而不是生产安全边界。可运行的核心已包含并测试。规划、策略、自我监控和自主循环研究模块在`experimental/`下明确隔离，因为提供的公共快照中缺少几个内部适配器。不声称采用、贡献者、下载或依赖项数量。
阅读[开发状态](docs/DEVELOPMENT_STATUS.md)、[架构](docs/ARCHITECTURE.md)和[路线图](docs/ROADMAP.md)。
## 贡献
欢迎外部贡献者。从[CONTRIBUTING.md](CONTRIBUTING.md)开始，打开一个聚焦的问题，并审查任何文件系统、shell、依赖项安装或浏览器更改的权限影响。安全问题应根据[安全.md](SECURITY.md)私下报告。
## 维护者
**Mostafa Selim Farag** — 高级Web应用程序开发人员
[devmostafa.com](https://www.devmostafa.com)
## 许可证
版权2026 Mostafa Selim Farag。在[Apache License 2.0](LICENSE)下许可。参见[NOTICE](NOTICE)以获取归属信息。
