Pioter MCP Server

Pioter is a "Best Practices Oracle" MCP server that provides dynamic advice, checklists, and patterns for various software technologies.

Features

• Technology Awareness: Automatically detects the technology from your query (e.g., React, Kubernetes, Python).
• Best Practices: Provides curated best practices and common mistakes.
• Checklists: Offers basic and advanced checklists for reviews.
• Configurable: Easily extendable via JSON configuration files.

Installation

1. Clone the repository:

   git clone <repository-url>
   cd piotermcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Configuration

To use this server with Antigravity or any MCP client (like Claude Desktop), add the following to your MCP configuration file:

{
  "mcpServers": {
    "pioter": {
      "command": "node",
      "args": ["/Users/piotr/workspace/piotermcp/dist/index.js"]
    }
  }
}

Running Locally

You can run the server locally for testing using the provided script:

./run_server.sh

Note: The server communicates via stdio (standard iasnput/output). It is designed to be run by an MCP client, not directly by a human in the terminal, although you will see it start up.

Usage

Ask Pioter about best practices, refactoring, or architecture.

Examples:

• "What are the best practices for React hooks?"
• "Give me a security checklist for Kubernetes."
• "How should I structure a Python FastAPI project?"

Tools

• refactor_advice: Get refactoring advice.
• technology_best_practices: Get general best practices.
• testing_guidelines: Get testing strategies.
• architecture_patterns: Get architectural recommendations.
• ops_deployment_principles: Get DevOps and deployment advice.
• security_checklist: Get security checklists.