# mujeebmohammed-gits/aigovernance-mcp architecture

> Architecture diagram of the GitHub repository mujeebmohammed-gits/aigovernance-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mujeebmohammed-gits/aigovernance-mcp
- Repository: https://github.com/mujeebmohammed-gits/aigovernance-mcp

## Overview

This repository implements an AI governance and compliance control tower. An agent submits an AI-call context to the MCP orchestrator, which checks policy and agent compliance, dispatches an allowed call through a provider integration, and gathers the response. The orchestrator also coordinates audit, usage, and monitoring capabilities. A separate internal LLM API is reachable from the orchestrator. The tree advertises Jira, Confluence, and Slack integrations, but their wiring is not shown in sampled source; those remain separate optional branches. Evidence is limited to the provided tree and excerpts.

Main entry points: [`mcp_service/mcp_service.py`](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/mcp_service/mcp_service.py) (MCP Orchestrator), [`integration/integration_layer.py`](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/integration/integration_layer.py) (Provider Integrations), [`usage_tracker/usage_tracker.py`](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/usage_tracker/usage_tracker.py) (Usage Tracking), [`slack_integration.py`](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/slack_integration.py) (Slack Integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Governance"]
  node_policy["Policy Engine"]
  node_registry["Agent Registry<br/>[agent_registry.py]"]
  node_provider_config["Provider Routing<br/>[provider_config.py]"]
end

subgraph group_execution["Call Execution"]
  node_orchestrator["MCP Orchestrator<br/>[mcp_service.py]"]
  node_integration_layer["Provider Integrations"]
end

subgraph group_operations["Operations"]
  node_audit["Audit Logging<br/>[audit_logger.py]"]
  node_usage["Usage Tracking<br/>[usage_tracker.py]"]
  node_usage_file["Usage JSONL"]
  node_dashboard["Monitoring Dashboard<br/>[dashboard.py]"]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_integrations["Integrations"]
  node_openai["OpenAI"]
  node_anthropic["Anthropic"]
  node_google["Google Gemini"]
  node_internal_api["Internal LLM API<br/>[server.py]"]
  node_slack["Slack Integration"]
  node_jira["Jira Integration"]
  node_confluence["Confluence Integration"]
end

node_agent(("Agent"))

node_agent -->|"submits call"| node_orchestrator
node_orchestrator -->|"evaluates policy"| node_policy
node_orchestrator -->|"checks compliance"| node_registry
node_orchestrator -->|"dispatches call"| node_integration_layer
node_integration_layer -.->|"calls provider"| node_openai
node_integration_layer -.->|"calls provider"| node_anthropic
node_integration_layer -.->|"calls provider"| node_google
node_orchestrator -->|"posts request"| node_internal_api
node_orchestrator -->|"coordinates logging"| node_audit
node_orchestrator -->|"coordinates tracking"| node_usage
node_usage -->|"persists events"| node_usage_file
node_orchestrator -->|"coordinates monitoring"| node_dashboard
node_slack -.->|"optional integration"| node_orchestrator
node_jira -.->|"optional integration"| node_orchestrator
node_confluence -.->|"optional integration"| node_orchestrator

click node_orchestrator "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/mcp_service/mcp_service.py"
click node_policy "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/policy_engine/policy_engine_main.py"
click node_registry "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/agent_registry/agent_registry.py"
click node_provider_config "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/provider_config/provider_config.py"
click node_integration_layer "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/integration/integration_layer.py"
click node_internal_api "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/internal_llm_api/server.py"
click node_audit "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/audit/audit_logger.py"
click node_usage "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/usage_tracker/usage_tracker.py"
click node_dashboard "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/dashboard/dashboard.py"
click node_config "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/config/config.py"
click node_slack "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/slack_integration.py"
click node_jira "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/jira_integration.py"
click node_confluence "https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/confluence_integration.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_policy,node_registry,node_provider_config toneBlue
class node_orchestrator,node_integration_layer toneAmber
class node_audit,node_usage,node_usage_file,node_dashboard,node_config toneMint
class node_openai,node_anthropic,node_google,node_internal_api,node_slack,node_jira,node_confluence toneRose
class node_agent toneIndigo
```

## Components

### Governance

- [Policy Engine](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/policy_engine/policy_engine_main.py): `policy_engine/policy_engine_main.py`
- [Agent Registry](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/agent_registry/agent_registry.py): `agent_registry/agent_registry.py`
- [Provider Routing](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/provider_config/provider_config.py): `provider_config/provider_config.py`

### Call Execution

- [MCP Orchestrator](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/mcp_service/mcp_service.py): `mcp_service/mcp_service.py`
- [Provider Integrations](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/integration/integration_layer.py): `integration/integration_layer.py`

### Operations

- [Audit Logging](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/audit/audit_logger.py): `audit/audit_logger.py`
- [Usage Tracking](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/usage_tracker/usage_tracker.py): `usage_tracker/usage_tracker.py`
- **Usage JSONL**
- [Monitoring Dashboard](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/dashboard/dashboard.py): `dashboard/dashboard.py`
- [Configuration](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/config/config.py): `config/config.py`

### Integrations

- **OpenAI**
- **Anthropic**
- **Google Gemini**
- [Internal LLM API](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/internal_llm_api/server.py): `internal_llm_api/server.py`
- [Slack Integration](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/slack_integration.py): `slack_integration.py`
- [Jira Integration](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/jira_integration.py): `jira_integration.py`
- [Confluence Integration](https://github.com/mujeebmohammed-gits/aigovernance-mcp/blob/main/confluence_integration.py): `confluence_integration.py`

### Other components

- **Agent**

## Connections

- Agent → MCP Orchestrator: submits call
- MCP Orchestrator → Policy Engine: evaluates policy
- MCP Orchestrator → Agent Registry: checks compliance
- MCP Orchestrator → Provider Integrations: dispatches call
- Provider Integrations → OpenAI: calls provider
- Provider Integrations → Anthropic: calls provider
- Provider Integrations → Google Gemini: calls provider
- MCP Orchestrator → Internal LLM API: posts request
- MCP Orchestrator → Audit Logging: coordinates logging
- MCP Orchestrator → Usage Tracking: coordinates tracking
- Usage Tracking → Usage JSONL: persists events
- MCP Orchestrator → Monitoring Dashboard: coordinates monitoring
- Slack Integration → MCP Orchestrator: optional integration
- Jira Integration → MCP Orchestrator: optional integration
- Confluence Integration → MCP Orchestrator: optional integration