my-ai-tools MCP工具

📋 Prerequisites

Prerequisites for Windows

1. Git for Windows - Includes Git Bash (required for running shell scripts) - Download from: https://git-scm.com/download/win - During installation, choose "Use Git and optional Unix tools from the Command Prompt" to add Git Bash to PATH

2. jq (JSON processor) - Auto-installed via winget if available - Manual install: winget install -e --id jqlang.jq

Installation

curl -fsSL https://cli.devin.ai/install.sh | bash

One-Line Installer (Recommended)

Install directly without cloning the repository:

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash

Security Note: Review the script before running:

> curl -fsSL https://ai-tools.itman.fyi/install.sh -o install.sh
> cat install.sh  # Review the script
> bash install.sh
> 

Options:

```bash

Backup existing configs before installing

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash -s -- --backup

Manual Installation

Clone the repository and run the installer:

git clone https://github.com/jellydn/my-ai-tools.git
cd my-ai-tools
./cli.sh

Options:

• --dry-run - Preview changes without making them
• --backup - Backup existing configs before installing
• --no-backup - Skip backup prompt
• -y / --yes - Non-interactive mode; only installs/configures your active tool set (amp, codex, ctx, cursor, fx, kilo, muse, opencode, open_code_review, pi, omp, antigravity, ai-switcher, claude, reasonix). Shared infra (plugins, skills, global tools) still installed. Auto-activated in CI/piped input.
• --migrate-gemini - One-step Gemini→Antigravity CLI migration

Forward: Install to Home (`cli.sh`)

Copy configurations from this repository to your home directory (~/.claude/, ~/.config/opencode/, etc.):

./cli.sh [--dry-run] [--backup] [--no-backup] [-y|--yes] [--migrate-gemini]

Install and configure fx interactively

./cli.sh

Official macOS/Linux installer

curl -fsSL https://dev.meta.ai/install.sh | sh

🪟 Windows Installation

The installer supports Windows via PowerShell or Git Bash.

Installation

curl -fsSL https://claude.ai/install.sh | bash

MCP Servers Setup

Automatic Setup (Recommended)

Run the setup script to configure MCP servers:

./cli.sh

The script will prompt you to install each MCP server:

• context7 - Documentation lookup for any library
• sequential-thinking - Multi-step reasoning for complex analysis
• qmd - Quick Markdown Search with AI-powered knowledge management
• agentmemory - "Persistent memory" per the tool's branding; we use it session-only (qmd is the durable KB; see ~/.ai-tools/MEMORY.md)
• fff - Fast file search with built-in memory for AI agents
• react-grab-mcp - React component extraction and analysis
• logpilot - AI-powered log analysis and tmux session monitoring

Manual Setup

For Claude Code

Configuration in ~/.claude/mcp-servers.json:

{
	"mcpServers": {
		"context7": {
			"command": "npx",
			"args": ["-y", "@upstash/context7-mcp@latest"]
		},
		"sequential-thinking": {
			"command": "npx",
			"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
		},
		"qmd": {
			"command": "qmd",
			"args": ["mcp"]
		},
		"agentmemory": {
			"command": "npx",
			"args": ["-y", "@agentmemory/mcp"]
		},
		"fff": {
			"type": "stdio",
			"command": "fff-mcp",
			"args": []
		},
		"react-grab-mcp": {
			"command": "npx",
			"args": ["-y", "@react-grab/mcp", "--stdio"]
		},
		"logpilot": {
			"command": "logpilot",
			"args": ["mcp-server"]
		}
	}
}

Or use the CLI (installed globally for all projects):

claude mcp add --scope user --transport stdio context7 -- npx -y @upstash/context7-mcp@latest
claude mcp add --scope user --transport stdio sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
claude mcp add --scope user --transport stdio qmd -- qmd mcp
claude mcp add --scope user --transport stdio agentmemory -- npx -y @agentmemory/mcp
claude mcp add --scope user --transport stdio fff -- fff-mcp  # Requires: curl -fsSL https://dmtrkovalenko.dev/install-fff-mcp.sh | bash
claude mcp add --scope user --transport stdio logpilot -- logpilot mcp-server  # Requires: cargo install logpilot
claude mcp add --scope user --transport stdio sem -- sem-mcp  # Requires: cargo install --git https://github.com/Ataraxy-Labs/sem sem-mcp

Auto-Install: ./cli.sh automatically installs Rust via rustup when these cargo-dependent MCP servers are selected, so you don't need to install Rust manually beforehand (manual claude mcp add still requires a pre-installed Rust toolchain).

MCP Scopes: - --scope user (global): Available across all projects - --scope local (default): Only in current project directory - --scope project: Stored in .mcp.json for team sharing

Managing MCP Servers

```bash

If the above fails, check your Claude Code installation and subscription

#### Installation

The setup script (`./cli.sh`) automatically checks marketplace availability before installing plugins. If marketplace is unavailable, it will offer to install local plugins only.

**Automated installation (recommended):**

**Manual installation** (requires marketplace access):

Plugin installation format: plugin-name@marketplace-name

then you install plugin 'plannotator' from that marketplace

claude plugin marketplace add backnotprop/plannotator claude plugin install plannotator@plannotator

claude plugin marketplace add jarrodwatts/claude-hud claude plugin install claude-hud@claude-hud

claude plugin marketplace add max-sixty/worktrunk claude plugin install worktrunk@worktrunk

claude plugin marketplace add openai/codex-plugin-cc claude plugin install codex@openai-codex

claude plugin marketplace add JuliusBrussee/caveman claude plugin install caveman@caveman

Install skills from this repository (jellydn/my-ai-tools)

Recommended: Install all skills at once using npx skills add

npx skills add jellydn/my-ai-tools --yes --global --agent claude-code

Or install interactively (select which skills to install)

npx skills add jellydn/my-ai-tools --global --agent claude-code

Available skills: accountable-engineering, prd, ralph, qmd-knowledge, codemap, adr, handoffs, pickup, pr-review, slop, tdd, code-quality-review, commit-atomic, draft-pull-request, docs-update, llm-wiki, plannotator-setup-goal, portless-local, security-audit, tmux, blindspot-pass, implementation-logger, quiz-me, spec-interview, capability-experiments, code-review, context-discovery, doc-search, git-context, orchestrating-fusion

Skills are installed to ~/.agents/skills/ with symlinks in ~/.claude/skills/

```

Troubleshooting

Skills installation issues?

If you encounter issues:

1. Check npx availability: Ensure Node.js and npx are installed (npx --version)
2. Use local skills: The setup script automatically falls back to local skills from skills/ folder
3. Manual installation: Copy skill folders directly to ~/.claude/skills/
4. Interactive mode: Run without --yes flag to select specific skills

Common issues:

• "npx not found" → Install Node.js to use remote skill installation, or use local skills via ./cli.sh
• "Permission denied" → Try running without sudo, or use --global flag
• "Skills already installed" → Remove existing skills first with npx skills remove --global

Plugin List

Key Marketplace Plugins

codemap - Orchestrates parallel codebase analysis producing 7 structured documents in .planning/codebase/:

• STACK.md - Technologies, dependencies, configuration
• INTEGRATIONS.md - 3rd party APIs, databases, auth
• ARCHITECTURE.md - System patterns, layers, data flow
• STRUCTURE.md - Directory layout, key locations
• CONVENTIONS.md - Code style, patterns, error handling
• TESTING.md - Framework, structure, mocking, coverage
• CONCERNS.md - Tech debt, bugs, security issues

prd - Generate Product Requirements Documents

ralph - Convert PRDs to JSON for autonomous agent execution

qmd-knowledge - Project-specific knowledge management (guide)

Agent Guidelines

Installed to ~/.config/devin/AGENTS.md with instructions for:

• Session management with tmux
• Using fff MCP for file search
• Following best practices from ~/.ai-tools/best-practices.md
• qmd knowledge management integration
• Git safety guidelines

Usage

```bash

🚀 Quick Start

Example: The repository 'backnotprop/plannotator' registers as marketplace 'plannotator',

🎬 Demo

🖥️ Devin CLI (Optional)

Cognition AI's autonomous coding agent with deep cloud integration. Homepage | Docs

<details> <summary><strong>Installation & Configuration</strong></summary>

Configuration

Run the setup script to install configurations to ~/.config/devin/:

./cli.sh

The setup script automatically deploys MCP servers and agent guidelines.

🔄 Bidirectional Config Sync

𝒇x (Optional)

fx is a small native coding agent from Vercel Labs. The installer uses its official setup script on macOS and Linux, then installs this repository's global guidance to ~/.fx/AGENTS.md when fx is detected.

```bash

🎼 Muse Code (Optional)

Muse Code is Meta's coding agent for terminal and CI workflows, powered by Muse Spark 1.2. Meta brought it out of beta on August 31, 2026 with inter-session messaging, multi-agent workflows, safe conversation rewind, and a developer-preview SDK. Announcement | Docs | SDK

```bash

Add OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL, and OPENAI_EMBEDDING_MODEL to .env

npm install npm run index # build data/index.json (server mode) npm run index:browser # build public/index-browser.json (browser mode) source .env # load OPENAI_BASE_URL for server mode npm run dev # serve http://localhost:3000 ```

The assistant only answers from the retrieved repository excerpts, cites the source file paths, and says "This is not documented in the repository." when the context is insufficient.

The landing page also has a browser mode that runs the embedding and an instruction-tuned model (Qwen2.5-Coder-0.5B-Instruct) in the browser via WebGPU. Browser mode downloads the ~9 MB index and the ~300 MB model on the user's device.

Option 1: PowerShell (Recommended for Windows)

```powershell

To pass options, download first, then run the local file:

irm https://ai-tools.itman.fyi/install.ps1 -OutFile install.ps1 .\install.ps1 -DryRun

**Local execution:**

Option 2: Git Bash

```bash

List all configured servers

claude mcp list

One-step Gemini→Antigravity CLI migration

curl -fsSL https://ai-tools.itman.fyi/install.sh | bash -s -- --migrate-gemini ```

Muse Code SDK (Developer Preview)

The SDK is a per-project TypeScript dependency, not another global CLI. It requires Node.js 20+ and a separately installed muse binary, which it launches as a local muse serve host over the Muse Session Protocol:

npm install @muse-code/sdk

The pre-1.0 SDK supports starting and resuming sessions, streaming responses, handling permission requests, and controlling the local Muse host. Minor releases can contain breaking changes during the developer preview.

Verify Claude CLI supports plugins

claude plugin list

🔌 MCP Servers & Plugins Overview

Plugins

Prerequisites

Before installing plugins, ensure:

1. Claude Code subscription - Active subscription with plugin support
2. Plugin marketplace access - Verify marketplace is enabled for your repository
3. Network connectivity - Required for downloading marketplace plugins

To check marketplace availability:

```bash

Official plugins

claude plugin install typescript-lsp@claude-plugins-official claude plugin install pyright-lsp@claude-plugins-official claude plugin install context7@claude-plugins-official claude plugin install frontend-design@claude-plugins-official claude plugin install learning-output-style@claude-plugins-official claude plugin install swift-lsp@claude-plugins-official claude plugin install lua-lsp@claude-plugins-official claude plugin install code-simplifier@claude-plugins-official claude plugin install rust-analyzer-lsp@claude-plugins-official claude plugin install claude-md-management@claude-plugins-official

Community plugins (add marketplace first)