### Install Marketplace MCP Server Example Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Examples of deep links for installing MCP servers that exist in the built-in marketplace. If the server ID is not found, it falls back to the Marketplace page. ```text mtarsier://install/mcp/filesystem mtarsier://install/mcp/github mtarsier://install/mcp/brave-search mtarsier://install/mcp/playwright mtarsier://install/mcp/memory ``` -------------------------------- ### Install Custom MCP Server (stdio) Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of a deep link to install a custom MCP server using stdio. This opens the Marketplace page for manual installation. ```text mtarsier://install/mcp?name=weather&command=npx&args=-y,mcp-weather-server ``` -------------------------------- ### Open Deep Link from Windows Terminal Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of using the 'start' command in Windows to test the mTarsier deep link for installing an MCP. ```powershell start mtarsier://install/mcp/filesystem ``` -------------------------------- ### Install Skill (repository only) Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of a deep link to install a skill from a GitHub repository. This opens mTarsier on the Skills page. ```text mtarsier://install/skill?source=anthropics/courses ``` -------------------------------- ### Install Custom MCP Server (with environment variable) Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of a deep link to install a custom MCP server, including an environment variable for configuration. This opens the Marketplace page for manual installation. ```text mtarsier://install/mcp?name=my-api&command=npx&args=-y,mcp-my-api&env.API_KEY=sk-test123 ``` -------------------------------- ### Install Skill (specific skill name) Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of a deep link to install a specific skill from a GitHub repository, including a skill name. This opens mTarsier on the Skills page. ```text mtarsier://install/skill?source=obra/superpowers/brainstorming ``` -------------------------------- ### Install Custom MCP Server (remote URL) Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of a deep link to install a custom MCP server hosted at a remote URL. This opens the Marketplace page for manual installation. ```text mtarsier://install/mcp?name=remote-tools&url=https://api.example.com/mcp ``` -------------------------------- ### Install Marketplace Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/marketplace.md Installs a marketplace server by its name to a specified client. Supports adding parameters for server configuration. ```bash # Install a marketplace server by name tsr install filesystem --client claude-desktop ``` ```bash # With parameters tsr install filesystem --client claude-desktop --param path=/Users/you/projects ``` -------------------------------- ### Search and Install Skill via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/marketplace.md Searches the skills registry for a given query and installs a skill from GitHub to a specified client. ```bash # Search the registry tsr skills search "frontend design" ``` ```bash # Install from GitHub tsr skills install anthropics/courses --client claude-code ``` -------------------------------- ### Install MCP Server from Marketplace Source: https://github.com/mcp360/mtarsier/blob/main/README.md Installs a specified MCP server from the marketplace into your configured clients. Use this to quickly add new server integrations. ```bash tsr install brave-search # install from marketplace ``` -------------------------------- ### Install Dependencies and Run mTarsier in Development Mode Source: https://github.com/mcp360/mtarsier/blob/main/README.md Installs project dependencies using pnpm, prepares the Tauri sidecar, and starts the mTarsier development server. Requires Rust, Node.js, and pnpm. ```bash cd mTarsier pnpm install cd src-tauri && bash scripts/prepare-sidecar.sh && cd .. pnpm tauri dev ``` -------------------------------- ### Install Dependencies and Prepare Sidecar Source: https://github.com/mcp360/mtarsier/blob/main/AGENTS.md Commands to install project dependencies and prepare the CLI sidecar binary before development. ```bash pnpm install cd src-tauri && bash scripts/prepare-sidecar.sh && cd .. ``` -------------------------------- ### Install Skill Link Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Link directly to your skill from your repository or blog, allowing users to install it via mTarsier. ```markdown [Get this skill](mtarsier://install/skill?source=your-org/your-skill-repo) ``` -------------------------------- ### Install MCP Server Link Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Add an 'Install with mTarsier' button to your README or docs page for users to easily install MCP servers. ```markdown [Install with mTarsier](mtarsier://install/mcp/your-server-id) ``` -------------------------------- ### Install Marketplace Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Use the `tsr install` command to add servers from the marketplace. You can specify parameters like the server type and client. ```bash # Install a marketplace server tsr install filesystem --client claude-desktop # With parameters tsr install filesystem --client claude-desktop --param path=/Users/you/projects ``` -------------------------------- ### Open Deep Link from Linux Terminal Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Example of using the 'xdg-open' command in Linux to test the mTarsier deep link for installing an MCP. ```bash xdg-open "mtarsier://install/mcp/filesystem" ``` -------------------------------- ### Install Skill from GitHub Repository via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Installs all skills from a specified GitHub repository to a given client. Ensure the client is correctly specified. ```bash tsr skills install anthropics/courses --client claude-code ``` -------------------------------- ### Install Skill for a Client Source: https://github.com/mcp360/mtarsier/blob/main/README.md Installs a specified skill from the marketplace to a particular client. Use this to add new functionalities to your AI tools. ```bash tsr skills install anthropics/courses/prompt-eng --client claude-code ``` -------------------------------- ### Open Deep Links from macOS Terminal Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Examples of using the 'open' command in macOS to test various mTarsier deep links, including installation and marketplace links. ```bash open "mtarsier://install/mcp/filesystem" open "mtarsier://install/skill?source=anthropics/courses" open "mtarsier://marketplace" ``` -------------------------------- ### Install macOS Dependencies Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Installs Xcode command-line tools on macOS, a prerequisite for building the application. ```bash xcode-select --install ``` -------------------------------- ### List Installed Skills via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Lists all skills currently installed for a specific client. Use the --json flag for machine-readable output. ```bash tsr skills list --client claude-code ``` ```bash tsr skills list --client claude-code --json ``` -------------------------------- ### Clone and Run mTarsier Locally Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Clones the mTarsier repository, installs frontend dependencies, prepares the Rust CLI sidecar, and starts the application in development mode. ```bash # Clone the repo git clone https://github.com/mcp360/mTarsier.git cd mTarsier # Install frontend dependencies (pnpm version must match packageManager field) pnpm install # Build the tsr CLI sidecar binary (required before first run) cd src-tauri && bash scripts/prepare-sidecar.sh && cd .. # Start dev mode pnpm tauri dev ``` -------------------------------- ### Install Linux (Debian/Ubuntu) Dependencies Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Installs necessary development libraries and tools for building on Debian-based Linux distributions. ```bash sudo apt update sudo apt install -y libwebkit2gtk-4.1-dev build-essential curl wget file \ libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev ``` -------------------------------- ### Install Linux (Fedora) Dependencies Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Installs necessary development libraries and tools for building on Fedora-based Linux distributions. ```bash sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \ libxdo-devel libappindicator-gtk3-devel librsvg2-devel ``` -------------------------------- ### List Servers via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Use the `tsr list` command to view installed MCP servers. You can list all servers, servers for a specific client, or get JSON output. ```bash # All servers across all clients tsr list # For a specific client tsr list --client claude-desktop # JSON output tsr list --json ``` -------------------------------- ### Install Skill via npx Command Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Use this command to install a specific skill from a GitHub repository using the npx command-line tool. ```bash npx skills add obra/superpowers/brainstorming ``` -------------------------------- ### Install Specific Skill from Multi-Skill Repository via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Installs a single, named skill from a GitHub repository that contains multiple skills. Specify the skill name using the --name flag. ```bash tsr skills install obra/superpowers/brainstorming --client claude-code --name brainstorming ``` -------------------------------- ### Install pnpm Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Installs the required version of pnpm globally. Ensure this version matches the one specified in the project's package.json. ```bash npm install -g pnpm@10.28.2 ``` -------------------------------- ### Exported MCP Setup JSON Structure Source: https://github.com/mcp360/mtarsier/blob/main/docs/export-import.md This JSON structure represents a typical export of MCP servers and skills for a client. It includes versioning, export timestamp, and detailed configurations for clients, their servers, and installed skills. ```json { "version": "1.0", "exported_at": "1712745600", "clients": [ { "id": "claude-desktop", "name": "Claude Desktop", "servers": [ { "name": "filesystem", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects"] } ], "skills": [ { "name": "frontend-design", "description": "Create production-grade frontend interfaces", "content": "---\nname: \"frontend-design\"\n..." } ] } ] } ``` -------------------------------- ### Conventional Commit Message Examples Source: https://github.com/mcp360/mtarsier/blob/main/AGENTS.md Examples illustrating the Conventional Commits format for commit messages, including type, scope, and description. ```git feat(marketplace): add server search filtering fix(clients): prevent concurrent detection calls perf(clients): offload detection to spawn_blocking chore: update Cargo dependencies ``` -------------------------------- ### List Skills for a Client Source: https://github.com/mcp360/mtarsier/blob/main/README.md Lists all installed skills for a specific client. Helps in managing and auditing skills on a per-client basis. ```bash tsr skills list --client claude-code ``` -------------------------------- ### Stdio Server Configuration Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Example JSON configuration for a stdio-based MCP server, specifying the command, arguments, and environment variables. ```json { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects"], "env": { "NODE_ENV": "production" } } } ``` -------------------------------- ### Install with mTarsier Deep Link Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md This HTML and JavaScript snippet demonstrates how to trigger a deep link to install an MCP with mTarsier. It includes logic to detect if the mTarsier app was opened and redirects to the website if it wasn't. ```html ``` -------------------------------- ### Run mTarsier in Development Mode Source: https://github.com/mcp360/mtarsier/blob/main/AGENTS.md Command to start the mTarsier application in development mode using Tauri. ```bash pnpm tauri dev ``` -------------------------------- ### Tauri Command Invocation Example Source: https://github.com/mcp360/mtarsier/blob/main/AGENTS.md Demonstrates how to call Tauri commands from the React frontend. Always use try/catch for safety. ```typescript invoke("command_name", { args }) .then(result => console.log(result)) .catch(error => console.error(error)); ``` -------------------------------- ### Install mTarsier CLI via Homebrew Source: https://github.com/mcp360/mtarsier/blob/main/README.md This command installs the mTarsier CLI tool using Homebrew. It is a convenient way to manage the CLI if you use Homebrew for package management. ```bash brew install mcp360/tap/tsr ``` -------------------------------- ### Navigate to mTarsier Pages Source: https://github.com/mcp360/mtarsier/blob/main/docs/deep-links.md Examples of deep links to navigate directly to specific pages within the mTarsier application. ```text mtarsier://marketplace mtarsier://skills mtarsier://clients mtarsier://config mtarsier://settings ``` -------------------------------- ### Remote Server Configuration Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Example JSON configuration for a remote MCP server, specifying the URL for SSE or Streamable HTTP connections. ```json { "my-remote": { "url": "https://api.example.com/mcp" } } ``` -------------------------------- ### List Detected Clients via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Get a list of all detected AI clients using the `tsr clients` command. JSON output is available with the `--json` flag. ```bash tsr clients tsr clients --json ``` -------------------------------- ### List Supported Clients Source: https://github.com/mcp360/mtarsier/blob/main/README.md Displays a list of detected AI clients and their configuration file paths. Helps in verifying client integration and locating configuration files. ```bash tsr clients ✓ claude-desktop ~/Library/Application Support/Claude/... ✓ cursor ~/.cursor/mcp.json ✓ windsurf ~/.codeium/windsurf/mcp_config.json ``` -------------------------------- ### Rust CLI Binary Preparation Script Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Shell script to build the tsr CLI binary for use as a Tauri sidecar. ```shell scripts/prepare-sidecar.sh ``` -------------------------------- ### Prepare Tauri Sidecar Binary Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md This script builds the `tsr` CLI Rust binary and places it in the expected location for Tauri to use as a sidecar. Re-run this after modifying Rust code in `src-tauri/src/bin/tsr.rs`. ```bash cd src-tauri && bash scripts/prepare-sidecar.sh && cd .. ``` -------------------------------- ### List MCP Servers Source: https://github.com/mcp360/mtarsier/blob/main/README.md Lists all available MCP servers and the clients they are associated with. Useful for understanding server distribution across your AI tools. ```bash tsr list filesystem → Claude Desktop, Cursor, Windsurf brave-search → Claude Desktop github → Cursor, Windsurf ``` -------------------------------- ### Build Production Release Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Builds a release version of the mTarsier application, including a bundled binary for your platform. The output is located in `src-tauri/target/release/bundle/`. ```bash # Build a release binary + bundled app (.dmg / .exe / .deb) pnpm tauri build ``` -------------------------------- ### Build Signed Production Release for macOS Source: https://github.com/mcp360/mtarsier/blob/main/AGENTS.md Command to create a signed production build for macOS. Requires setting the APPLE_SIGNING_IDENTITY environment variable. ```bash APPLE_SIGNING_IDENTITY="Developer ID Application: ..." pnpm release:signed ``` -------------------------------- ### SKILL.md File Structure Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Defines the basic structure of a SKILL.md file, including required YAML frontmatter and instructional body. ```markdown --- name: "my-skill-name" description: "What this skill does" --- ## Goal Describe what this skill should accomplish. ## When To Use List the situations where this skill should be applied. ## Steps 1. First step 2. Second step 3. Final step ``` -------------------------------- ### Add Custom Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Add custom MCP servers using the `tsr add` command. Supports stdio, remote URLs, environment variables, and bearer tokens. Use `--force` to overwrite existing servers. ```bash # stdio server tsr add my-server --client claude-desktop --command npx --args -y mcp-my-server # Remote URL server (SSE / Streamable HTTP) tsr add my-remote --client claude-code --url https://api.example.com/mcp # With environment variables tsr add github --client cursor --command npx --args -y @modelcontextprotocol/server-github --env GITHUB_TOKEN=ghp_xxx # With bearer token (HTTP servers) tsr add my-api --client claude-code --url https://api.example.com/mcp --bearer-token sk-xxx # Overwrite existing server tsr add filesystem --client claude-desktop --command npx --args -y @modelcontextprotocol/server-filesystem /tmp --force ``` -------------------------------- ### Search for Skills via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Use the 'tsr skills search' command to find skills available in the registry. Enclose search terms in quotes. ```bash tsr skills search "frontend design" ``` -------------------------------- ### Manage Server Config via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md View, show, or edit MCP server configuration files using the `tsr config` command. Use `--show` to print contents or `--edit` to open in your default editor. ```bash # Show config file path tsr config claude-desktop # Print config contents tsr config claude-desktop --show # Open in $EDITOR tsr config claude-desktop --edit ``` -------------------------------- ### Clone mTarsier Repository Source: https://github.com/mcp360/mtarsier/blob/main/README.md Clones the mTarsier project from GitHub to your local machine. This is the first step for development or contributing to the project. ```bash git clone https://github.com/mcp360/mTarsier.git ``` -------------------------------- ### Edit MCP Server Configuration Source: https://github.com/mcp360/mtarsier/blob/main/README.md Opens the configuration file for a specific client in your default editor ($EDITOR). Allows for direct modification of server settings. ```bash tsr config cursor --edit # open config in $EDITOR ``` -------------------------------- ### macOS DMG Packaging Script Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Shell script used for packaging the application into a macOS DMG file. ```shell scripts/make-dmg.sh ``` -------------------------------- ### mTarsier Project Structure Source: https://github.com/mcp360/mtarsier/blob/main/CONTRIBUTING.md Overview of the directory structure for the mTarsier project, separating frontend (React/TypeScript) and backend (Rust/Tauri) components. ```tree src/ # React frontend (TypeScript + Tailwind v4) pages/ # Full-page views (Dashboard, Clients, Config, Skills, Marketplace, etc.) components/ # UI components organized by feature marketplace/ # Marketplace install dialogs, cards config/ # Config editor, toolbar, backup panel skills/ # Skill cards, dialogs clients/ # Client detection, filtering settings/ # Theme picker, settings controls store/ # Zustand state stores (clientStore, configStore, skillStore, etc.) hooks/ # Custom React hooks lib/ # Client registry, utilities, MCP utils types/ # TypeScript type definitions data/ # Marketplace server definitions layouts/ # App layout (sidebar + content) src-tauri/ # Rust backend src/ commands/ # Tauri commands clients.rs # Client detection, config reading config.rs # Config writing, backups skills.rs # Skills listing, install, delete audit.rs # Audit logging cli.rs # CLI installation io.rs # Import/export server.rs # mTarsier internal store utils.rs # Path expansion, home dir updater.rs # Auto-update tray.rs # Menu bar tray icon flow.rs # Flow import/export bin/tsr.rs # CLI binary entry point lib.rs # Tauri plugin registration, app setup marketplace.rs # Marketplace registry (Rust side) registry.rs # Client registry (Rust side) tray.rs # Tray icon setup scripts/ prepare-sidecar.sh # Builds tsr CLI binary for Tauri sidecar make-dmg.sh # macOS DMG packaging binaries/ # Compiled sidecar binaries (gitignored) ``` -------------------------------- ### Ping Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Check the status of an MCP server using the `tsr ping` command. You can ping a server globally or for a specific client. ```bash tsr ping filesystem tsr ping filesystem --client claude-desktop ``` -------------------------------- ### Remove Skill via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/skill-installation.md Removes a specified skill from a client. Ensure the skill name and client are accurate. ```bash tsr skills remove skill-name --client claude-code ``` -------------------------------- ### Disable/Enable Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Temporarily disable or enable an MCP server without removing it using `tsr disable` and `tsr enable`. Disabled servers are stored in mTarsier but removed from client config. ```bash # Disable — removes from client config, saves to mTarsier store tsr disable filesystem --client claude-desktop # Enable — restores to client config from mTarsier store tsr enable filesystem --client claude-desktop ``` -------------------------------- ### Remove Server via CLI Source: https://github.com/mcp360/mtarsier/blob/main/docs/mcp-installation.md Remove an MCP server from a client using the `tsr remove` command. ```bash tsr remove filesystem --client claude-desktop ``` -------------------------------- ### Ping MCP Server Source: https://github.com/mcp360/mtarsier/blob/main/README.md Pings a specified MCP server to check its responsiveness. Useful for diagnosing connectivity issues. ```bash tsr ping # ping a server ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.