MCPhappey is a next-generation, modular implementation of the Model Context Protocol (MCP). It enables dynamic, multi-domain server hosting, authentication, dynamic client registration, and tool/resource integration—built for extensibility, rapid innovation, and “living on the edge” with the latest tech.

flowchart TD
    subgraph Core
        CoreLib[MCPhappey.Core]
        Common[MCPhappey.Common]
    end
    subgraph Abstractions
        Auth[MCPhappey.Auth]
        Decoders[MCPhappey.Decoders]
        Scrapers[MCPhappey.Scrapers]
        Simplicate[MCPhappey.Simplicate]
    end
    Tools[MCPhappey.Tools]
    subgraph Servers
        JSON[MCPhappey.Servers.JSON]
        SQL[MCPhappey.Servers.SQL]
    end
    subgraph Clients
        Console[MCPhappey.Clients.Console]
        Web[MCPhappey.Clients.Web]
    end
    WebApi[MCPhappey.WebApi]

    Console --> WebApi
    Web --> WebApi
    WebApi --> CoreLib
    WebApi --> Common
    WebApi --> Auth
    WebApi --> Decoders
    WebApi --> Scrapers
    WebApi --> Simplicate
    WebApi --> Tools
    WebApi --> JSON
    WebApi --> SQL
    Tools -->|Integrates| Auth
    Tools -->|Integrates| CoreLib
    Tools -->|Integrates| Common
    Tools -->|Integrates| Decoders
    Tools -->|Integrates| Scrapers
    Tools -->|Integrates| Simplicate

• Clients (Console, Web) interact with the WebApi host, which orchestrates all core, abstraction, and tool packages.
• Core provides the dynamic server logic, AI/memory, and shared abstractions.
• Abstractions (Auth, Decoders, Scrapers, Simplicate) encapsulate authentication, content decoding, and data extraction.
• Tools offer integrations with external services (Bing, GitHub, OpenAI, SharePoint, etc.).
• Servers (JSON, SQL) provide static and dynamic MCP server implementations.
• WebApi is the main entry point for web-based access, integrating all packages.

1. Build all projects:

   dotnet build

2. Run the Web API:

   dotnet run --project src/Samples/MCPhappey.WebApi

3. (Optional) Start the web client:

   cd src/Clients/MCPhappey.Clients.Web
   npm install
   npm run dev

• Clean code, best practices, and “living on the edge” (NoWarn, latest tech).
• Modular by design: add new servers, tools, or clients with minimal friction.
• See each package’s README for deep dives and extension points.

• MCPhappey.Core
• MCPhappey.Common
• MCPhappey.Auth
• MCPhappey.Decoders
• MCPhappey.Scrapers
• MCPhappey.Simplicate
• MCPhappey.Tools
• MCPhappey.Servers.JSON
• MCPhappey.Servers.SQL
• MCPhappey.Clients.Console
• MCPhappey.Clients.Web
• MCPhappey.WebApi