Omnissiah MCP服务器
用于AI工具生态系统的MCP（模型上下文协议）服务器。使Claude、Kimi和其他AI助手能够安全地控制Blender、浏览器和系统工具。
🎯 目的
此存储库包含充当以下角色的MCP服务器 USB-C用于人工智能 --将AI模型连接到外部工具的标准化接口。
| 服务器 | 功能 | 状态 |
|---|---|---|
| 搅拌机 | 3D建模、渲染、程序生成 | 已计划 |
| 浏览器 | 网页抓取、SEO分析、表单自动化 | 已计划 |
| 系统 | 安全外壳命令、文件操作 | 已计划 |
🏗️ 建筑
AI Models (Kimi, Claude) → MCP Client → MCP Server → Tool
↓
Sandboxed, audited, validated🔒 安全
- 沙盒执行 --具有最低权限的Docker容器
- 输入验证 --Pydantic模式，严格的类型检查
- 审核日志记录 --所有操作均已记录并可审查
- 仅限白名单 --无任意代码执行
🚀 快速开始
# Clone
git clone https://github.com/machineaccess1010-sketch/omnissiah-mcp.git
cd omnissiah-mcp
# Install dependencies
pip install -r requirements.txt
# Run Blender MCP server
python -m mcp.blender.server📦 安装
通过pip（发布时）
pip install omnissiah-mcp发展
git clone https://github.com/machineaccess1010-sketch/omnissiah-mcp.git
pip install -e ".[dev]"🛠️ 暴露的工具
搅拌机MCP
create_primitive(type, name, location)--创建基本的3D形状apply_modifier(object, modifier_type)--添加网格修改器render_scene(output_path, resolution)--渲染到文件export_mesh(format, path)--导出为各种格式
浏览器MCP
navigate(url)--加载网页screenshot(path)--捕获页面图像extract_data(selector)--报废结构化数据fill_form(fields)--自动提交表单
系统MCP
execute_command(command, args)--安全外壳执行（仅限白名单）read_file(path)--读取文件内容write_file(path, content)--写入文件内容list_directory(path)--列出目录内容
🔧 配置
创建 ~/.config/omnissiah/mcp.yaml:
servers:
blender:
enabled: true
port: 8080
sandbox: true
browser:
enabled: true
headless: true
user_agent: "Omnissiah-Bot/1.0"
system:
enabled: true
allowed_commands: ["git", "ls", "cat", "grep"]
forbidden_patterns: ["rm -rf", "sudo", ">/dev"]🧪 测试
# Run all tests
pytest
# Test specific server
pytest tests/test_blender_mcp.py
# Security tests
pytest tests/test_security.py -v🤝 贡献
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-tool) - 提交更改(
git commit -m 'Add amazing tool') - 推送到分支(
git push origin feature/amazing-tool) - 打开拉取请求
所有捐款必须通过：
- 安全扫描(
trivy,gitleaks,semgrep) - 单元测试(
pytest) - 类型检查(
mypy) - Linting(
ruff,black)
📜 许可证
MIT许可证——见 许可证 了解详情。
🙏 致谢
- 模型上下文协议 --Anthropic的开放标准
- Blender Python API --用于3D操作
- 剧作家 --用于浏览器自动化
______________________________________________________________________