使用说明
MCPSOIDS
MCPSOIDS 是模型上下文协议的最终“主动鲁棒性”实现。它将强化的Node.js MCP服务器与前卫的玻璃形态控制中心相结合,用于实时监控和工具执行。
💎 愿景
MCPSOIDS超越了简单的“聊天机器人工具”,创建了一个受监管的、可观察的生态系统,在人工智能代理和本地系统操作之间架起了一座桥梁。
- 视觉优势:一个“赛博朋克Glassmorphism”UI,使监控系统健康状况成为一种视觉享受。
- 生产硬化:内置速率限制、错误边界和严格的类型安全。
- 双重架构:后端(服务器)和前端(控制中心)解耦,可实现最大的可扩展性。
🚀 主要特点
🧠 后端(Cortex)
- 完全符合MCP:实现工具发现和执行的标准化协议。
- 本地工具:
- 📂 文件系统:
list_directory,read_file,write_file(沙盒)。 - 📊 系统:
memory_usage,ping.
- 📂 文件系统:
- 安全第一:内置速率限制和原产地验证。
👁️ 控制中心(眼睛)
- Next.js 16(涡轮包):快速的表演。
- 实时遥测:轮询服务器运行状况和连接状态。
- 交互式工具目录:通过更严格的JSON验证直接从UI执行工具。
- 前卫设计:顺风CSS v4驱动的美学。
⚡ 快速开始
Windows(自动)
我们为Windows用户提供了一个统一的启动器。
.\start_production.ps1
这将自动:
- 启动 MCP服务器 (端口3000)。
- 启动 控制中心 (端口3001)。
- 打开必要的终端窗口。
手动设置
1.服务器
cd mcp_server_ref
bun install
bun run build
$env:MCP_AUTH_TOKEN = "local-mcp-token"
node bin/mcp-server-ref.js --enable-fs --cors-origin http://localhost:3001
2.控制中心
cd mcp-control-center
bun install
bun run build
$env:MCP_SERVER_URL = "http://127.0.0.1:3000"
$env:MCP_AUTH_TOKEN = "local-mcp-token"
$env:MCPSOIDS_ADMIN_TOKEN = "local-admin-token"
$env:MCPSOIDS_UI_SECRET = "local-ui-secret"
$env:MCPSOIDS_ALLOW_PRIVATE_MCP = "true"
bun run start -- -p 3001
🛠️ 建筑学
graph TD
User[User / AI Agent] -->|HTTP/JSON| Frontend[Control Center]
Frontend -->|MCP Protocol| Backend[MCP Server]
Backend -->|Access| FS[File System]
Backend -->|Access| Sys[System Specs]
📦 技术栈
- 运行时:Node.js v20+
- 框架:Next.js 16.0.8(React 19)
- 语言:TypeScript 5.x
- 样式:顺风CSS 4+框架运动
- 测试:剧作家(E2E)
📄 许可证
此项目根据Apache许可证2.0获得许可。-看 package.json 文件以获取详细信息。
美国东部时间。2026//LehroSolutions//高级代理运营
许可证
版权所有©2026 Lehro Solutions。根据 Apache许可证2.0。参见 通知.
文档
规范文档中心: docs/.docs/index.md
安装
bun install
bun run build
bun run start
看 安装.md.
如何使用
看 docs/how to use.md 查看完整的操作指南。
安全
看 安全.md.
文档
当前的公开文件可在 docs/index.html.开始 docs/current/start-here.md 用于范围、当前更改、工作流、架构、安全性、质量和贡献指导。
最新公开更改
- 操作员控制中心
- 健康、指标、审计完整性和能力目录
- 根安全实验室和现场工具执行
文档以规范的Markdown格式以及生成的HTML和JSON格式进行维护。跑 pnpm docs:build 更换后 docs/current/*.md 和 pnpm docs:check 在公开发布之前。
Bun和CI
此存储库使用 Bun 1.3.14 和目标 节点24+ 用于JavaScript工具和CI。
rm -f package-lock.json
bun install
bun run build
bun run test
bun run docs:check
不要使用 npm ci;Bun是规范的安装路径。跑 bun install 在依赖关系更改后提交结果 bun.lock.