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.