skills.rest
organvm-i-theoria
organvm-i-theoriaOFFICIAL
Explore all skills by this author →
GitHub

mcp-server-orchestrator

Configure, deploy, and troubleshoot Model Context Protocol servers for AI agent workflows.

Updated May 16, 2026
Search Tags:#troubleshooting#ai agents#mcp#model context protocol#server configuration#json-rpc#fastmcp
One-click install
npx skills add https://github.com/organvm-i-theoria/_agent-ontology --skill mcp-server-orchestrator-organvm-i-theoria
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-server-orchestrator
Source: https://github.com/organvm-i-theoria/_agent-ontology/tree/main/.agents/skills/mcp-server-orchestrator
Command: npx skills add https://github.com/organvm-i-theoria/_agent-ontology --skill mcp-server-orchestrator-organvm-i-theoria

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up and debugging MCP servers involves scattered config files, cryptic JSON-RPC errors, and client-specific quirks across Codex Desktop, Claude Code, and other tools. This Skill consolidates configuration schemas, troubleshooting procedures, and server templates into one operational guide. ## Core Features & Use Cases - Server Configuration: Provides JSON schemas and examples for Python (uvx), Node (npx), and local development servers across multiple MCP clients. - Systematic Troubleshooting: Walks through connection failures, authentication issues, and transport problems with log locations and diagnostic commands. - Custom Server Development: Includes FastMCP (Python) and MCP SDK (TypeScript) boilerplate for building tools, resources, and prompts. - Use Case: Your MCP server shows up in Codex Desktop but exposes no tools. Use this Skill to test the server independently, inspect the JSON-RPC handshake, check client logs, and fix the tool registration. ## Quick Start Ask the AI to help configure a new MCP server in your client config file or diagnose why an existing MCP server connection is failing.

Frequently Asked Questions about mcp-server-orchestrator

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

FAQPage Schema
How do I configure an MCP server in Claude Desktop?▼

Add an entry to the mcpServers object in claude_desktop_config.json with a command, args, and optional env variables. On macOS the file lives in ~/Library/Application Support/Claude; restart the client fully after editing.

How do I build a custom MCP server in Python?▼

Use the FastMCP library: create a FastMCP instance, decorate functions with @mcp.tool(), @mcp.resource(), or @mcp.prompt(), then call mcp.run(). The server communicates over stdio by default for client integration.

Why is my MCP server not showing tools in the client?▼

Missing tools usually mean the server crashed on startup, the command path is wrong, or dependencies are not installed. Test the server standalone, check client MCP logs, and use absolute paths in the configuration.

FastMCP vs MCP TypeScript SDK for building servers?▼

FastMCP offers a decorator-based Python API with minimal boilerplate, while the TypeScript SDK requires explicit request handlers for tool listing and calls. Choose based on your runtime environment and language preference.

How do I debug MCP JSON-RPC connection timeouts?▼

Send a manual initialize request via stdin to verify the server responds to the protocol handshake. Check that the server writes logs to stderr rather than stdout, since stdout is reserved for protocol messages.

Can I run multiple MCP servers in one client configuration?▼

Yes, define multiple named entries under mcpServers, each with its own command and environment. Organize servers by domain such as filesystem, database, and API integrations, and enable only those needed for the current task.

Related Skills

Explore More Software Engineering Skills→
viktorbezdekviktorbezdek
10

mcp-server

Create and maintain MCP servers exposing Tools, Resources, and Prompts for Claude Code.

Community
Intermediate
InternScienceInternScience
28

molclaw-scp-server

Configure and manage the MCP server for MolClaw tool communication.

Official
Intermediate
mashharukimashharuki
2

creating-secrets-using-best-practices

Manage AWS Secrets Manager secrets with KMS encryption, rotation, and IAM policies.

Community
Advanced
theflysurfertheflysurfer

julien-mcp-word-uvx

Install Word MCP server via UVX and update .mcp.json configuration.

Community
Advanced