add-mcp-server

Add and configure MCP server entries in pi-mcp-adapter configurations.

1|Updated Aug 29, 2023
One-click install
npx skills add https://github.com/alicanerdogan/dotfiles --skill add-mcp-server-alicanerdogan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/alicanerdogan/dotfiles/tree/main/pi/skills/add-mcp-server
Command: npx skills add https://github.com/alicanerdogan/dotfiles --skill add-mcp-server-alicanerdogan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Add an MCP server configuration to pi-mcp-adapter. Determine scope (global or project) and server type (stdio or HTTP), then write the config and verify the connection.

Core Features & Use Cases

  • Determine scope and where it should be stored: global config at ~/.pi/agent/mcp.json and project-local config at .pi/mcp.json, with project-local taking precedence.
  • Determine server type: stdio (local command) or HTTP (remote URL), with example structures for each.
  • Write and verify: read existing mcpServers, merge the new server, save JSON, trigger a reload, and test a connection.

Quick Start

Provide the scope (global or project) and server type, supply the server details, then add the MCP server configuration and verify the connection.

Frequently Asked Questions about add-mcp-server

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

FAQPage Schema
How do I add an MCP server to a project configuration?▼

Adding an MCP server involves reading the existing mcpServers object, merging the new entry, writing to .pi/mcp.json or ~/.pi/agent/mcp.json, reloading, and validating the connection.

What is the difference between global and project-scoped MCP server configuration?▼

Project-scoped configuration is stored at .pi/mcp.json and takes precedence over the global configuration located at ~/.pi/agent/mcp.json, allowing localized server setups.

Does MCP server configuration support both local commands and remote URLs?▼

Yes, MCP server configuration supports stdio servers for local commands and HTTP servers for remote URLs, allowing you to define the server type that fits your connection requirements.

How do I verify an MCP server connection after updating the configuration?▼

After writing the merged configuration to disk, trigger a reload of the pi-mcp-adapter and test the connection to validate that the newly added MCP server is reachable.

What happens if I add an MCP server when an existing configuration is already present?▼

The process merges the new MCP server entry with the existing mcpServers object, preserving current configurations while appending the new server details before writing the updated JSON to disk.