python-mcp

Implements MCP servers in Python using EvoAgentX for the THYROX meta-framework.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/jcg-admin/IACT-ui --skill python-mcp-jcg-admin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-mcp
Source: https://github.com/jcg-admin/IACT-ui/tree/main/.claude/skills/python-mcp
Command: npx skills add https://github.com/jcg-admin/IACT-ui --skill python-mcp-jcg-admin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mcp, evoagentx, faiss-cpu, sentence-transformers.

What problem does it solve? Building MCP servers and Python components for the THYROX meta-framework requires consistent conventions for tool contracts, adapter layers, FAISS persistence, and subprocess safety, which are easy to get wrong without phase-by-phase guidance. ## Core Features & Use Cases - Phase-aligned guidance: Provides specific checklists for DIAGNOSE, DESIGN/SPECIFY, IMPLEMENT, and TRACK/EVALUATE phases when working on registry/mcp/*.py and bootstrap.py. - MCP server implementation order: Defines a concrete sequence from the EvoAgentX adapter layer and dataclasses to tool registration and settings.json configuration. - Safety and correctness rules: Enforces timeouts on exec_cmd/exec_python, blocks destructive command patterns, ensures FAISS index persistence, and requires idempotent bootstrap scripts. - Use Case: When adding a new MCP tool to the THYROX registry, follow the Skill to specify input/output schemas in requirements-spec.md, implement the adapter with full type hints, and verify security constraints before closing the phase. ## Quick Start Ask the AI to implement a new MCP server tool in registry/mcp following the python-mcp conventions for the THYROX framework.

Frequently Asked Questions about python-mcp

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

FAQPage Schema
How do I implement an MCP server in Python?▼

Start with the EvoAgentX adapter layer and its return dataclasses, then implement each adapter function with full type hints, create the MCP server file that registers tools, and test with a tools/list JSON-RPC call before updating settings.json.

What should an MCP tool specification include?▼

Each MCP tool needs explicit input schemas with typed fields, a JSON-serializable dict output schema, preconditions, error behavior that returns errors in the dict instead of raising, and a timeout for any operation that can block.

How do I make subprocess execution safe in an MCP server?▼

Configure timeouts on exec_cmd and exec_python so they never block indefinitely, and block destructive patterns such as rm -rf / and fork bombs. Identify all commands and risky patterns during the diagnosis phase before writing code.

Why does FAISS index data disappear after a crash?▼

The index is lost when it is not persisted after each store_memory call. Persist the FAISS index to disk on every write and verify thread-safety when concurrent code modifies the index.

When should bootstrap.py be idempotent?▼

Bootstrap scripts must always be idempotent so running them twice does not break the environment. Verify this during the evaluation phase along with checking that no secrets are hardcoded and paths come from env vars or arguments.