Content
# Tool List
**One-click AI toolkit — 11 MCP servers + 11 skills + 205 expert agents**
Works with Claude Code, Codex, Hermes, OpenClaw
## Quick Start
```bash
git clone --recurse-submodules https://github.com/a976xw7td/MCP-Toolkit.git
cd MCP-Toolkit
bash scripts/install.sh # macOS / Linux / Windows Git Bash or WSL2
```
Follow the prompts to choose a preset and enter API keys (~2 minutes).
## Platform Compatibility
### Installation Script / install.sh
| System | Runtime | Description |
|------|---------|------|
| macOS | Direct Run | Fully Supported |
| Linux | Direct Run | Fully Supported |
| Windows | Git Bash or WSL2 | Native CMD / PowerShell does not support bash |
> **Windows Users**: Install [Git for Windows](https://git-scm.com/download/win) to get Git Bash, right-click on the folder and select "Git Bash Here" to run the script.
### Agent Support
| Agent | macOS | Linux | Windows | Notes |
|-------|-------|-------|---------|------|
| **Claude Code** | ✅ | ✅ | ✅ | Windows installation script requires Git Bash/WSL2 |
| **Codex** | ✅ | ✅ | ✅ | Windows installation script requires Git Bash/WSL2 |
| **Hermes** | ✅ | ✅ | ❌ | Hermes does not support Windows |
| **OpenClaw** | ✅ | ✅ | ✅ | Only installs skills; role system architecture is different, 205 roles do not apply |
### Installation Content
| Content | Claude Code | Codex | Hermes | OpenClaw |
|------|-------------|-------|--------|----------|
| 11 Skills | ✅ | ✅ | ✅ | ✅ |
| MCP Server Configuration | ✅ | ✅ | ✅ | ⚠️ Plugin system is different, requires manual configuration |
| 205 Expert Roles | ✅ | ✅ | ✅ | ❌ OpenClaw has a single workspace architecture, does not support multiple roles |
## What's Included
### MCP Servers (11)
| Server | Function | Runtime | API Key |
|--------|------|--------|---------|
| filesystem | Read and write local files | npx | Not required |
| git | Git operations | uvx | Not required |
| memory | Cross-session memory | npx | Not required |
| sequential-thinking | Structured reasoning | npx | Not required |
| fetch | Web content scraping | uvx | Not required |
| time | Time zone/time | uvx | Not required |
| desktop-commander | Terminal command execution | npx | Not required |
| context7 | Real-time library document injection | npx | Not required |
| github | GitHub repository operations | npx | GitHub PAT (free) |
| brave-search | Web search | npx | Brave API (free tier) |
| firecrawl | Deep web crawling | npx | Firecrawl API (free tier) |
### Skills (11)
| Skill | Description |
|------|------|
| autopilot | Automatic driving - give goals, automatically plan and execute |
| ralph | Persistent retry - loop until task is completed and verified |
| ultrawork | Ultra-deep work mode - highest quality output |
| team | Multi-agent collaboration - N workers execute in parallel |
| ultraqa | Comprehensive quality review - function, regression, security, accessibility |
| deep-dive | Deep code analysis - understand system architecture from source code |
| trace | Root cause analysis - track bugs to specific source |
| wiki | Document generation - README, API documentation, architecture documentation |
| scientific-writing | Academic writing assistant - papers, reports, literature review |
| review | Code review - correctness, performance, security, maintainability |
| security-review | Security audit - OWASP Top 10 full coverage |
### Expert Agents (205)
205 professional agents from [agency-agents](https://github.com/msitarzewski/agency-agents), covering:
Engineering · Design · Marketing · Sales · Finance · Product · Testing · Game development · Security · Academic · More
> Located in `~/.claude/agents/` (Claude Code) and `~/.codex/rules/` (Codex) after installation.
## Presets
### minimal (Recommended for beginners)
- No API keys required
- 8 MCP servers
- Downloads approximately 80–120 MB on first run
### developer (Recommended for developers)
- Requires free GitHub Personal Access Token
- 10 MCP servers (adds GitHub + search)
- Get token: https://github.com/settings/tokens (permissions: repo, read:user)
### full (Full-featured)
- Requires GitHub PAT
- Optional Brave Search API + Firecrawl API (both have free tiers)
- 11 MCP servers, full features enabled
## Requirements
| Dependency | Purpose | Installation |
|------|------|------|
| Node.js 18+ | Run npx-type MCP servers | https://nodejs.org |
| uv | Run uvx-type MCP servers (git/fetch/time) | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
| Python 3.8+ | Used internally by installation script | Usually pre-installed |
| git | Clone this repository | https://git-scm.com |
**Windows Additional Requirements**: Git Bash (bundled with Git for Windows) or WSL2 to run bash installation script. MCP servers themselves natively support Windows.
## What You Can Do After Install
### Use autopilot to automatically complete tasks
```
autopilot: Help me build a React project with login functionality
```
### Use team mode for parallel development
```
/team 4:executor "Implement user management CRUD API and testing"
```
### Use review for code review
```
review the authentication module
```
### Use security-review for security audit
```
security-review src/api/
```
### Use deep-dive to understand unfamiliar code
```
deep-dive How does the payment processing module work
```
### Activate expert roles (Claude Code / Codex)
```
Use Backend Architect to help me design the database structure for this project
Use UI Designer to help me generate a beautiful HTML report template
```
## Manual Install
If the automatic installation script encounters issues:
**Claude Code:**
```bash
bash scripts/convert.sh minimal
# Skills
cp -r integrations/claude-code/skills/* ~/.claude/skills/
# Roles
mkdir -p ~/.claude/agents
find agents -name "*.md" ! -path "*/integrations/*" ! -path "*README*" \
! -path "*/strategy/*" ! -path "*/scripts/*" \
-exec cp {} ~/.claude/agents/ \;
# MCP Configuration: merge integrations/claude-code/mcp-config.json into ~/.claude.json
```
**Codex:**
```bash
bash scripts/convert.sh minimal
cp -r integrations/codex/skills/* ~/.codex/skills/
# MCP Configuration: append integrations/codex/mcp-config.toml to ~/.codex/config.toml
```
**Hermes:**
```bash
bash scripts/convert.sh minimal
cp -r integrations/hermes/skills/* ~/.hermes/skills/
cp integrations/hermes/mcp-config.yaml ~/.hermes/mcp-config.yaml
hermes reload
```
## Contributing
PRs welcome! To add a new MCP server, add a YAML config in `mcp/servers/`.
## License
MIT
*agency-agents submodule [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents)*
