openlol (Altamsh04)

OpenLoL😆

打开本地操作层——让任何AI代理直接安全地访问您的机器终端。

🔄 状态：正在积极开发中

______________________________________________________________________

它做什么

OpenLoL 启动本地 模型上下文协议 服务器的作用域为您计算机上的一个文件夹。将任何兼容MCP的AI客户端指向生成的URL，它可以读取文件、写入文件、运行终端命令和检查系统信息——所有这些都在您定义的边界内。

没有云。没有接力。你的机器，你的文件夹，你的代币。

______________________________________________________________________

快速开始

# Recommended: install globally
npm i -g openlol

# Or install locally
npm i openlol

# Expose the current folder
openlol .

______________________________________________________________________

CLI选项

______________________________________________________________________

连接到游标

添加 .cursor/mcp.json 在项目根目录中（或 ~/.cursor/mcp.json 全球）：

{
  "mcpServers": {
    "openlol": {
      "url": "http://localhost:3333/mcp?token=",
      "transport": "http"
    }
  }
}

每次服务器启动时都会打印令牌。每次都会生成一个新的令牌。

______________________________________________________________________

可用工具

所有文件和命令操作都是 沙盒到您指定的文件夹。目录遍历被阻止。

______________________________________________________________________

用例

文件和项目管理

*“创建一个 ideas.md 归档并添加10个SaaS创业想法。”* *“全部重命名 .txt 此文件夹中的文件 .md."* *“显示此项目的文件夹结构。”*

系统检查

*“我的笔记本电脑上还有多少存储空间？”* *“我目前的内存使用情况如何？”* *“列出包含单词PATH的所有环境变量。”*

开发工作流程

*“跑 npm install 然后 npm run build 并向我展示输出结果。"* *“检查 package.json 存在，然后阅读并总结依赖关系。"* *“创建新 src/utils 文件夹和脚手架a helpers.ts 文件。"*

脚本编写和自动化

*“编写一个shell脚本来备份所有内容 .json 文件到a backup/ 子文件夹并运行它。”* *“跑 git status 告诉我哪些文件发生了变化。"*

______________________________________________________________________

安全模型

• 每一个请求 /mcp 和 /sse 需要会话令牌（Bearer标头或 ?token= 查询参数）。
• 所有文件和命令操作仅限于通过传递的文件夹 -f。转义根的路径将被拒绝。
• 令牌是每次启动时新生成的UUID v4——会话之间永远不会重用任何令牌。
• /health 是唯一的公共端点。

绑定到 localhost 仅 （默认设置）。在没有额外加固的情况下，不要将此服务器暴露在公共互联网上。

______________________________________________________________________

运输支持

______________________________________________________________________

技术栈

• TypeScript --严格模式，NodeNext模块
• **@modelcontextprotocol/sdk\*\*--MCP服务器+传输
• 快速 --HTTP层
• 指挥官 --CLI
• 黄道带 --运行时输入验证
• 通用唯一标识符 --会话令牌生成

______________________________________________________________________

路线图

• 发布到npm openlol
• 配置文件支持(.openlolrc)
• 每个会话有多个文件夹作用域
• Https隧道集成用于远程访问
• 工具允许/拒绝列表配置
• 用于会话监控的Web UI

______________________________________________________________________

许可证

麻省理工学院