Skip to content

Add European Parliament MCP Server project pages (main, features, docs) with full ISMS documentation links #1065

@pethers

Description

@pethers

🎯 Objective

Create three new HTML pages for the European Parliament MCP Server project following the same pattern as existing Hack23 project pages (black-trigram.html, compliance-manager.html, cia-project.html), including all ISMS documentation links.

📋 Background

The European Parliament MCP Server is a new Hack23 project that implements the Model Context Protocol (MCP) to provide AI assistants with structured access to European Parliament open datasets. It achieves SLSA Level 3, maintains 80%+ test coverage, and is fully ISMS-compliant.

This project needs homepage presence with three pages:

  • european-parliament-mcp.html — Main project page (overview, features, links)
  • european-parliament-mcp-features.html — Detailed feature descriptions
  • european-parliament-mcp-docs.html — Architecture & ISMS documentation hub

📊 Current State

✅ Acceptance Criteria

  • european-parliament-mcp.html created following compliance-manager.html pattern
  • european-parliament-mcp-features.html created following cia-compliance-manager-features.html pattern
  • european-parliament-mcp-docs.html created following cia-compliance-manager-docs.html pattern with ALL documentation links below
  • All pages include proper <head> meta tags (description, keywords, OG, hreflang, canonical, schema.org)
  • All pages use existing styles.css without modification
  • All pages link back to each other and to the GitHub repo
  • All ISMS documentation cards included in the docs page
  • All pages validated for WCAG 2.1 AA accessibility (Lighthouse Accessibility = 100)

🛠️ Implementation Guidance

Files to Create

european-parliament-mcp.html — Copy structure from compliance-manager.html:

  • Hero section: "European Parliament MCP Server" with npm/GitHub badges
  • Key features: Full MCP implementation, EU Parliament data access, TypeScript, SLSA Level 3, 80%+ coverage
  • Links to features, docs, GitHub, npm package
  • Badges: OpenSSF Scorecard, SLSA Level 3, npm version, build status

european-parliament-mcp-features.html — Copy structure from cia-compliance-manager-features.html:

  • MCP Tools: get_meps, get_plenary_sessions, get_voting_records, search_documents, get_committee_info, get_parliamentary_questions, analyze_voting_patterns, track_legislation, generate_report
  • Data Access: MEPs, Plenary, Committees, Documents, Questions
  • Security features: Rate limiting, Zod validation, security headers, audit logging

european-parliament-mcp-docs.html — Copy structure from cia-compliance-manager-docs.html with these doc links:

Documentation Cards for european-parliament-mcp-docs.html

All links follow pattern https://github.com/Hack23/European-Parliament-MCP-Server/blob/main/:

Section Title Link
Architecture 🏛️ Current Architecture ARCHITECTURE.md
Architecture 🏛️ Future Architecture FUTURE_ARCHITECTURE.md
Behavior 🔄 State Diagrams STATEDIAGRAM.md
Behavior 🔄 Future State Diagrams FUTURE_STATEDIAGRAM.md
Process 🔄 Process Flowcharts FLOWCHART.md
Process 🔄 Future Flowcharts FUTURE_FLOWCHART.md
Security 🔐 Security Architecture SECURITY_ARCHITECTURE.md
Security 🔐 Future Security Architecture FUTURE_SECURITY_ARCHITECTURE.md
Business 💼 SWOT Analysis SWOT.md
Business 💼 Future SWOT FUTURE_SWOT.md
DevOps 🔧 CI/CD Workflows .github/WORKFLOWS.md
DevOps 🔧 Future Workflows FUTURE_WORKFLOWS.md
Conceptual 🧠 Concept Mindmaps MINDMAP.md
Conceptual 🧠 Future Concept Maps FUTURE_MINDMAP.md
Data 📊 Data Model DATA_MODEL.md
Data 📊 Future Data Model FUTURE_DATA_MODEL.md
Testing 🧪 Unit Tests Test Results: https://hack23.github.io/European-Parliament-MCP-Server/docs/test-results/ / Test Plan: docs/UnitTestPlan.md
Testing 📊 Test Coverage https://hack23.github.io/European-Parliament-MCP-Server/docs/coverage/
Testing 🔍 E2E System Tests https://hack23.github.io/European-Parliament-MCP-Server/docs/e2e-results/
Testing ⚡ Performance Tests PERFORMANCE_GUIDE.md
API 📘 API Documentation https://hack23.github.io/European-Parliament-MCP-Server/docs/api/
Continuity 🔄 Business Continuity BCPPlan.md
Lifecycle 📅 Lifecycle Management End-of-Life-Strategy.md
Financial 💰 Financial Security Plan FinancialSecurityPlan.md
Threat 🛡️ Evidence-Based Threat Model THREAT_MODEL.md
CRA 🏛️ CRA Assessment CRA-ASSESSMENT.md

Key Project Details for Content

  • Project name: European Parliament MCP Server
  • GitHub: https://github.com/Hack23/European-Parliament-MCP-Server
  • npm package: european-parliament-mcp-server
  • Language: TypeScript/Node.js
  • Description: MCP server providing AI assistants with structured access to European Parliament open datasets
  • Key stats: 268 unit tests passing, 23 E2E tests passing, 80%+ coverage, SLSA Level 3
  • Data source: https://data.europarl.europa.eu/api/v2/
  • ISMS compliance: ISO 27001:2022, NIST CSF 2.0, CIS Controls v8.1, GDPR

Approach

  1. Copy compliance-manager.htmleuropean-parliament-mcp.html, update all content
  2. Copy cia-compliance-manager-features.htmleuropean-parliament-mcp-features.html, update features
  3. Copy cia-compliance-manager-docs.htmleuropean-parliament-mcp-docs.html, update all links to point to github.com/Hack23/European-Parliament-MCP-Server
  4. Update all og:url, canonical, hreflang, and @id in schema.org to use correct URLs
  5. Set lang="en" on <html> element

🤖 Recommended Agent

Agent: @hack23-euparliamentmonitor-taskagent
Rationale: This issue involves creating static HTML pages for a European Parliament data project, following established Hack23 patterns.

For implementation, the agent will:

  • Analyze existing compliance-manager.html and cia-compliance-manager-docs.html as templates
  • Adapt all content sections for the European Parliament MCP Server project
  • Ensure all 26+ ISMS documentation cards are included with correct GitHub links
  • Validate WCAG 2.1 AA compliance and HTML validity

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions