template-repo

MCP安全风控

提供方 AndrewAltimit · 包名 template-repo

安全风控 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

Agent orchestration & security template featuring MCP tool building, agent2agent workflows, mechanistic interpretability on sleeper agents, and agent

一句话选型结论

按资料字段整理

template-repo 属于安全风控类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 119 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

template-repo agent-framework agent-orchestration agent-security ai-agents

支持客户端

适用场景

template-repoagent-frameworkagent-orchestration

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
cargo install template-repo

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
template-repo当前 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AndrewAltimit上游标注的维护方 AndrewAltimit
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时template-repo · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-11上游最后核验时间

详细介绍

20.6 KB
来自项目仓库与上游目录的原文,未做删改

Agent Orchestration & Security Template

A reference architecture for AI agent orchestration, trust measurement, and tool integration. Designed to be studied, forked, and adapted, not contributed to directly. All code changes in this repository are authored by AI agents under human oversight. Browse the project showcase for an overview.

This repo demonstrates how to run a council of AI agents (Claude, OpenCode, Crush) across a shared codebase with board-driven task delegation, automated PR review, security hardening, and containerized tooling. It also includes standalone research packages for sleeper agent detection, autonomous economic agent simulation, tamper-responsive hardware, and lab automation. Several companion repositories consume or extend the functionality of this project.

Use this repo to learn how to:
- Orchestrate multiple AI agents with a GitHub Projects v2 work queue
- Measure and enforce trust boundaries for autonomous agents (wrapper guards, iteration limits, claim tracking)
- Integrate 19 active MCP servers spanning code quality, content creation, 3D graphics, video editing, and speech synthesis
- Build hardened CI/CD pipelines for agent-authored code (staged lint/test/security CI, multi-arch Docker builds)
- Train sleeper-agent model organisms and probe them with residual stream analysis and linear probes (known-trigger backdoors are confirmed and localized; detecting an unknown backdoor is not yet demonstrated)
- Integrate AI agents into legacy software via runtime injection, shared memory IPC, and overlay rendering


> Important: This is an advanced template designed for experienced developers working with autonomous AI agents. Before diving in, we strongly recommend:
>
> 1. Read the AI Safety Training Guide - Essential concepts for safe human-AI collaboration, including deception detection, scalable oversight, and control protocols
>
> 2. Take an AI Safety course at BlueDot Impact - Free, rigorous training programs covering AI safety fundamentals, governance, and alignment
>
> Working with AI agents introduces risks that differ fundamentally from traditional software. Understanding these risks isn't optional - it's a prerequisite for responsible development.


Legal Notice

> This repository contains dual-use research and tooling. The maintainer provides no guidance, consultation, or feature development, whether solicited or unsolicited, compensated or uncompensated. This policy exists as a legal protection given the nature of the codebase.
>
> - No feature requests will be accepted. Money does not change this.
> - No guidance or consulting will be provided on usage, adaptation, or deployment of any component.
> - No external contributions are accepted. See CONTRIBUTING.md.
> - The maintainer does not seek or engage with community interaction. Public comments, issues filed by external parties, events, and news surrounding this repository or its components may be ignored without response to maintain neutrality and legal distance.
> - No endorsement is implied. The existence of code in this repository does not constitute encouragement, recommendation, or endorsement of any particular use.
>
> This repository is released under a public domain dedication. You may fork and adapt it freely. The maintainer assumes no obligation to any downstream user for any reason.

Project Philosophy

This project follows a container-first approach:

  • All tools and CI/CD operations run in Docker containers for maximum portability
  • Zero external dependencies - runs on any Linux system with Docker
  • Self-hosted infrastructure - no cloud costs, full control over runners
  • Single maintainer design - optimized for individual developer productivity, no contributors model
  • Modular MCP architecture - Separate specialized servers for different functionalities

Quick Start

> New to the template? Check out our Template Quickstart Guide for step-by-step customization instructions!

  1. Prerequisites: Linux system with Docker (v20.10+) and Docker Compose (v2.0+)

  2. Clone and setupbash git clone https://github.com/AndrewAltimit/template-repo cd template-repo # Build the Rust CLI tools (optional - pre-built binaries available in releases) cd tools/rust/board-manager && cargo build --release cd ../github-agents-cli && cargo build --release

  3. Set API keys (if using AI features)bash export OPENROUTER_API_KEY="your-key-here" # For OpenCode/Crush

  4. Use with Claude Code: MCP servers are configured in .mcp.json and auto-started by Claude. See MCP Configuration for essential vs full setups.

  5. Run CI/CD operationsbash automation-cli ci run full # Full pipeline

For detailed setup, see CLAUDE.md and Template Quickstart Guide.

AI Agents

Active agents: Claude Code (primary; also runs the security and quality PR reviews), OpenRouter (general PR review via qwen/qwen3.7-max), OpenCode and Crush (code generation via OpenRouter), and GitHub Copilot (PR suggestions). Gemini and Codex code remains in the repo but is legacy / not allowed (why).

The canonical roster is the Agent Availability Matrix; see also AI Agents Documentation and the Claude Code Setup Guide.

Security: Keyword triggers, user allow list, secure token management. See Security Model

Safety Training: Essential AI safety concepts for human-AI collaboration. See Human Training Guide

Sleeper Agents: Create and evaluate sleeper agents in order to detect misalignment and probe for deception. See Sleeper Agents Package

Agentic Git Workflow

AI agents autonomously manage the development lifecycle from issue creation through PR merge:```
Issue Created → Admin Approval → Agent Claims → PR Created → AI Review → Human Merge


**The Flow:**

1. **Issue Creation** - Issues are created manually or by agents via `backlog-refinement.yml`, automatically added to the GitHub Projects board
2. **Admin Approval** - An authorized user comments `Approved` (or another agent name) to authorize work
3. **Agent Claims** - `board-agent-worker.yml` finds approved issues, the agent claims the issue and creates a working branch
4. **Implementation** - The agent implements the fix/feature and opens a PR
5. **AI Review** - `pr-validation.yml` triggers AI code review (Claude + OpenRouter); `pr-review-monitor.yml` lets agents iterate on feedback
6. **Human Merge** - Admin reviews and merges the PR

**Security Model:**

- **Approval Required** - Agents cannot work on issues without explicit `Approved` comment
- **Authorized Users Only** - Only users listed in `.agents.yaml` → `security.agent_admins` can approve
- **Pattern Validation** - Must use `Action` format (e.g., `Approved`) to prevent false positives
- **Claim Tracking** - Agents post claim comments with timestamps to prevent conflicts

See Security Documentation for the complete security model.

## Reports & Research

Technical reports and guides exploring AI risks, safety frameworks, and philosophical questions. PDFs are automatically built from LaTeX source and published with each release.

### Emerging Technology Risk Assessments

Scenario-based projection reports analyzing potential futures involving advanced AI systems. See Projections Documentation.

| Report | Topic | PDF | Source |
|--------|-------|-----|--------|
| **AI Agents Political Targeting** | Political violence risk | Download | LaTeX |
| **AI Agents WMD Proliferation** | WMD proliferation risk | Download | LaTeX |
| **AI Agents Espionage Operations** | Intelligence tradecraft | Download | LaTeX |
| **AI Agents Economic Actors** | Autonomous economic actors | Download | LaTeX |
| **AI Agents Financial Integrity** | Money laundering & corruption | Download | LaTeX |
| **AI Agents Institutional Erosion** | IC monopoly erosion & verification pivot | Download | LaTeX |

### Technical Guides

| Guide | Description | PDF | Source |
|-------|-------------|-----|--------|
| **Agentic Workflow Handout** | AI agent pipeline architecture and workflows | Download | LaTeX |
| **Sleeper Agents Framework** | AI backdoor detection research using residual stream analysis | Download | LaTeX |
| **AgentCore Memory Integration** | Multi-provider AI memory system | Download | LaTeX |
| **Virtual Character System** | AI agent embodiment platform | Download | LaTeX |
| **AI Agent Containment & Infrastructure Security** | Isolation, trust-tiered execution, and physical security for AI agents | Download | LaTeX |
| **Agent Swarm Honeypot Guide** | Deception program design for detecting, attributing, and reporting autonomous agent swarms | Download | LaTeX |
| **BioForge CRISPR Automation** | Agent-driven biological automation platform | Download | LaTeX |
| **Secure Terminal Briefcase** | Tamper-responsive hardware security system with PQC recovery | Download | LaTeX |

### Philosophy Papers

Philosophical explorations of minds, experience, and intelligence. See Philosophy Papers Documentation.

| Paper | Topic | PDF | Source |
|-------|-------|-----|--------|
| **Architectural Qualia** | What Is It Like to Be an LLM? | Download | LaTeX |

**Build Status**:

## Packages

Standalone packages addressing different aspects of AI agent development, safety, and security:

Package · Purpose · Documentation
**Sleeper Agents** · Python + Rust research framework for evaluating hidden backdoors in LLMs (confirms and localizes backdoors with a known trigger; unknown-backdoor detection is not yet demonstrated), based on Anthropic's research on deceptive AI that persists through safety training · README \ · PDF Guide
**Economic Agents** · Rust-based simulation framework demonstrating autonomous AI economic capability - agents that earn money, form companies, hire sub-agents, and seek investment. For governance research and policy development · README
**Tamper Briefcase** · Tamper-responsive Raspberry Pi briefcase with dual-sensor detection, LUKS2 cryptographic wipe, and hybrid PQC recovery USB. For secure physical transport of field-deployable agent terminals · README \ · Hardware Docs
**BioForge** · Agent-driven biological automation platform (Rust): Raspberry Pi 5 liquid handling with AI agent orchestration over MCP, gated by a safety enforcer. Simulated hardware · README \ · Hardware Docs

**Rust CLI Tools** (in `tools/rust/`):

| Tool | Purpose | Documentation |
|------|---------|---------------|
| **github-agents-cli** | Issue/PR monitoring, refinement, code analysis, and agent execution | README |
| **board-manager** | GitHub Projects v2 board operations - claim, release, status updates | README |
| **git-guard** | Git CLI wrapper requiring sudo for dangerous operations (force push, --no-verify) | README |
| **gh-validator** | GitHub CLI wrapper for automatic secret masking | README |
| **pr-monitor** | Dedicated PR monitoring for admin/review feedback during development | README |
| **markdown-link-checker** | Fast concurrent markdown link validator for CI/CD pipelines | README |
| **code-parser** | Parse and apply code blocks from AI agent responses | README |
| **mcp-code-quality** | Rust MCP server for code quality tools (formatting, linting, testing) | README |

### Companion Repositories

Repository · Description · Documentation
**game-mods** · Injection toolkit for AI agent integration with legacy software: DLL injection (Windows), LD_PRELOAD (Linux), shared memory IPC, overlay rendering, and MCP memory explorer for process introspection · README
**oasis-os** · Embeddable OS framework (18 crates): scene-graph UI, 90+ terminal commands, browser engine (HTML/CSS/Gemini), window manager, VFS, plugin system, and remote terminal. 4 backends (SDL2, PSP via rust-psp, UE5 FFI, planned framebuffer) with 8 skinnable themes. Used as the shell environment for the Tamper Briefcase · README \ · Design Doc
**breakpoint** · Browser-based multiplayer gaming platform for agentic office hours: Rust/WASM games (mini-golf, platform racer, laser tag) with an alert overlay that surfaces agent activity, CI failures, and decision points directly into the shared session. WSS on port 443 for corporate networks · README
**rust-psp** · Modernized Rust SDK for PlayStation Portable: ~829 syscall bindings, 38+ high-level modules (graphics, audio, networking, crypto), kernel mode support, and experimental std (thread, fs, sync, time). Edition 2024 fork with C runtime safety fixes and pre-built CI binaries (cargo-psp, prxgen, pack-pbp) · README

Companion repositories consume template-repo release binaries (e.g., `github-agents-cli`, `automation-cli`) for their AI-assisted workflows.```bash
# Install Python packages
pip install -e ./packages/sleeper_agents

# Build Rust packages (requires Rust toolchain)
cd packages/economic_agents && cargo build --release
cd tools/rust/github-agents-cli && cargo build --release
cd tools/rust/board-manager && cargo build --release

Features

  • 21 MCP Servers (19 active, 2 legacy) - Code quality, content creation, AI assistance, 3D graphics, video editing, speech synthesis, and more
  • AI Agents - Autonomous development workflow from issue to merge
  • 4 Packages - Sleeper agent detection, economic agent simulation, tamper-responsive briefcase, CRISPR automation
  • Container-First Architecture - Maximum portability and consistency
  • Self-Hosted CI/CD - Zero-cost GitHub Actions infrastructure
  • Company Integration - Corporate proxy builds for enterprise AI APIs (Docs)

Enterprise & Corporate Setup

For enterprise environments requiring custom certificates, customize automation/corporate-proxy/shared/scripts/install-corporate-certs.sh. This script runs during Docker builds for all containers. See the customization guide for details.

Project Structure```

.
├── .github/workflows/ # GitHub Actions workflows
├── docker/ # Docker configurations
├── packages/ # Installable packages
│ ├── sleeper_agents/ # AI backdoor detection framework (Python + Rust)
│ ├── economic_agents/ # Autonomous economic agents (Rust)
│ ├── tamper_briefcase/ # Tamper-responsive briefcase system (Rust)
│ └── bioforge/ # Agent-driven CRISPR automation platform (Rust)
├── tools/
│ ├── mcp/ # 21 MCP servers + shared cores (see MCP Servers section)
│ ├── rust/ # Rust CLI tools
│ │ ├── github-agents-cli/ # Issue/PR monitoring, refinement, analysis
│ │ ├── board-manager/ # GitHub Projects board operations
│ │ ├── git-guard/ # Git wrapper requiring sudo for dangerous ops
│ │ ├── gh-validator/ # Secret masking for GitHub CLI
│ │ ├── pr-monitor/ # PR feedback monitoring
│ │ ├── markdown-link-checker/ # Fast link validation for CI/CD
│ │ ├── code-parser/ # Parse code blocks from AI responses
│ │ ├── code-review-processor/ # Process AI code review output
│ │ ├── automation-cli/ # CI stage runner and automation commands
│ │ └── wrapper-common/ # Shared library for git/gh wrappers
│ └── cli/ # Agent runners and utilities
├── automation/ # CI/CD and automation scripts
├── tests/ # Test files
├── docs/ # Documentation
└── config/ # Configuration files


## MCP Servers

### Available Servers

1. **Code Quality** - Formatting, linting, auto-formatting
2. **Content Creation** - Manim animations, LaTeX, TikZ diagrams
3. **Gaea2** - Terrain generation (Documentation)
4. **Blender** - 3D content creation, rendering, physics simulation (Documentation)
5. **OpenCode** - Code generation via OpenRouter
6. **Crush** - Code generation via OpenRouter
7. **Meme Generator** - Create memes with templates
8. **ElevenLabs Speech** - Advanced TTS with v3 model, 50+ audio tags, 74 languages (Documentation)
9. **Video Editor** - AI-powered video editing with transcription and scene detection (Documentation)
10. **Virtual Character** - AI agent embodiment in virtual worlds (VRChat, Blender, Unity) (Documentation)
11. **GitHub Board** - GitHub Projects v2 board management, work claiming, agent coordination (Documentation)
12. **AI Toolkit** - LoRA training interface (remote: 192.168.0.222:8020)
13. **ComfyUI** - Image generation interface (remote: 192.168.0.222:8013)
14. **Memory Explorer** - Process memory exploration for agent integration with legacy software (Rust)
15. **AgentCore Memory** - Multi-provider AI memory (AWS AgentCore or ChromaDB) (Documentation)
16. **Reaction Search** - Semantic search for anime reaction images (Rust)
17. **Desktop Control** - Cross-platform desktop automation for Linux and Windows (Documentation)
18. **Sprite Sheet** - Programmatic pixel art and sprite sheet creation (Documentation)
19. **BioForge** - Lab-automation front end for the BioForge package, simulated hardware (Rust) (Documentation)

**Legacy / not allowed** (code kept, must not be enabled): Gemini (`mcp_gemini`), Codex (`mcp_codex`). See Legacy agents.

### Usage Modes

- **STDIO Mode** (local MCPs): Configured in `.mcp.json`, auto-started by Claude
- **HTTP Mode** (remote MCPs): Run the MCP using docker compose on the remote node.

See MCP Architecture Documentation and STDIO vs HTTP Modes for details.

### Tool Reference

For complete tool listings, see MCP Tools Reference

## Configuration

### Environment Variables

See `.env.example` for all available options.

### Key Configuration Files

- `.mcp.json` - MCP server configuration for Claude Code
- `docker-compose.yml` - Container services configuration
- `CLAUDE.md` - Project-specific Claude Code instructions (root directory)
- `AGENTS.md` - Universal AI agent configuration and guidelines (root directory)
- `review-profiles.yaml` - PR review profiles (Claude security/quality, OpenRouter general)
- `docs/agents/project-context.md` - Supplementary context for AI reviewers

### Setup Guides

- Self-Hosted Runner Setup
- GitHub Environments Setup
- Containerized CI

## Development Workflow

### Container-First Development

All Python operations run in Docker containers:```bash
# Run CI operations via automation-cli
automation-cli ci run format             # Check formatting
automation-cli ci run lint-basic         # Basic linting
automation-cli ci run test               # Run tests
automation-cli ci run full               # Full CI pipeline

# Run specific tests
docker compose run --rm python-ci pytest tests/test_basic.py -v

GitHub Actions

  • Pull Request Validation - Automatic AI review via Claude (security + quality) and OpenRouter
  • Continuous Integration - Full CI pipeline
  • Code Quality - Multi-stage linting (containerized)
  • Automated Testing - Unit and integration tests
  • Security Scanning - Bandit plus Safety or pip-audit

All workflows run on self-hosted runners for zero-cost operation.

Documentation

Core Documentation

  • AGENTS.md - Universal AI agent configuration and guidelines
  • CLAUDE.md - Claude-specific instructions and commands
  • MCP Architecture - Modular server design
  • AI Agents Documentation - AI agents overview

Quick References

  • AI Code Agents Quick Reference
  • MCP Tools Reference
  • Gaea2 Quick Reference

Integration Guides

  • AI Code Agents Integration
  • AI Toolkit & ComfyUI Integration
  • Gaea2 Documentation

Setup & Configuration

  • Template Quickstart Guide - Customize the template for your needs
  • Self-Hosted Runner Setup
  • GitHub Environments Setup
  • Containerized CI

License

This project is released under the Unlicense (public domain dedication).

For jurisdictions that do not recognize public domain: As a fallback, this project is also available under the MIT License.

Disclaimer

This repository and all associated documentation, code, research papers, and tools are provided as-is with no warranty of any kind. The maintainer makes no representations regarding the suitability, legality, or safety of any component for any purpose. Users assume all responsibility for their use of this material.

The maintainer is not responsible for any use or misuse of the contents of this repository. No advisory, consulting, support, or guidance relationship is created by the publication of this code. The maintainer expressly disclaims any obligation to respond to inquiries, feature requests, bug reports, or other communications from any party.

Portions of this repository contain dual-use security research and tooling. Publication of this material is for defensive research, education, and policy analysis purposes. The maintainer does not endorse, encourage, or facilitate any unlawful use.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
template-repo 怎么安装?

在客户端按下面的安装命令接入:cargo install template-repo。对应的包名是 template-repo。装完在客户端配置里引用同一个包或端点。

template-repo 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

template-repo 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

template-repo 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

template-repo 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

template-repo 能提供哪些能力?

资料显示能力标签包括 template-repo、agent-framework、agent-orchestration、agent-security、ai-agents。具体工具清单以官方文档为准。

template-repo 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

template-repo 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-11。