使用说明

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操作
剧作家 --用于浏览器自动化

Omnissiah生态系统的一部分 | 工具 | 灵魂聊天