skills.rest
fusuyfusuy
fusuyfusuyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

add-mcp-server

Enables optional MCP servers from a shared library for a single project.

Updated Aug 23, 2026
Search Tags:#project setup#configuration#mcp#agent tooling#enable-mcp#server activation
One-click install
npx skills add https://github.com/fusuyfusuy/dot-agents --skill add-mcp-server-fusuyfusuy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/fusuyfusuy/dot-agents/tree/main/skills/add-mcp-server
Command: npx skills add https://github.com/fusuyfusuy/dot-agents --skill add-mcp-server-fusuyfusuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Global MCP server configurations apply to every project, which forces teams to either overload the global tool list or manually edit per-project config files. This Skill opts a single repository into extra MCP servers (ast, browser, context7, context, akatsuki) without touching the global set. ## Core Features & Use Cases - Project-scoped activation: Runs enable-mcp <server> <project-root> to symlink the shared library into .agents/plugins/ and merge a mcpServers entry into .pi/mcp.json. - Safe merge and removal: The script merges and unmerges config entries without clobbering the global entry's precedence, and supports disable for clean rollback. - Verification and documentation: Provides enable-mcp status checks and instructs adding an MCP section to the project's AGENTS.md so the choice is discoverable. - Use Case: A developer needs AST blast-radius analysis only in one repository, so they enable the ast server for that project while keeping the global tool list minimal. ## Quick Start Ask the agent to enable the ast MCP server for the current project using the enable-mcp command.

Frequently Asked Questions about add-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable an MCP server for a single project?▼

Run `enable-mcp <server> <project-root>` from the repository. This symlinks the shared library definition into `.agents/plugins/<name>` and merges a `mcpServers` entry into `.pi/mcp.json` for project scope only.

What MCP servers are available in the shared library?▼

The library offers ast (AST rewriting, LSP diagnostics, blast radius), browser (Playwright automation), context7 (framework docs lookup), context (context-mode), and akatsuki (second-brain gateway). Run `enable-mcp list` to see them.

Can I edit .pi/mcp.json by hand to add a server?▼

No. Hand edits tend to clobber the global entry's precedence. The enable-mcp script merges and unmerges `mcpServers` entries safely, so always use it for additions and removals.

Why is mimori not enabled per project?▼

mimori is already part of the global MCP set and defaults to the current workspace, so one global entry covers every repository. Enabling it per project would be redundant.

How do I remove an MCP server from a project?▼

Run `enable-mcp disable <server> <project-root>` to remove a single server, or `enable-mcp disable all <project-root>` to remove every project-scoped server. Changes take effect on the next session start.

Related Skills

Explore More Software Engineering Skills→
tony30552001tony30552001

setup-gbrain

Install gbrain CLI and initialize a local brain for Claude Code memory.

Community
Advanced
gatezhgatezh
2

sandbox-playwright

Drive Playwright to verify UI behavior inside a devcontainer.

Community
Advanced
appautomatonappautomaton
130

mcp-tools-catalog

Generate a project-local catalog of MCP tools from active servers into docs/mcp-tools.md.

Official
Intermediate
Space-DinosaursSpace-Dinosaurs
12

agentic-disable

Append an opt-out marker to AGENTS.md to disable agentic-engineering prompts.

Official
Intermediate