References a GitHub repository for IIA resources through an environment variable (IIA_GITHUB_REPO), allowing the server to potentially sync or version the structured IIA documentation.
Converts IIA resources from HTML to markdown format with proper frontmatter, organizing professional standards and guidance documents for AI consumption.
Required as a runtime environment for the MCP server, listed as a prerequisite (v18+) for running the server that provides access to IIA resources.
Utilized for package management and running scripts to build, scrape content, and start the MCP server providing IIA resources.
Used as the implementation language for the MCP server components, including the scraper and server logic that delivers IIA content.
Parses YAML frontmatter for rich metadata in IIA content, enabling advanced features like relevance scoring and standard number detection.
IIA-MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to Institute of Internal Auditors (IIA) professional standards and resources.
Overview
This project creates an MCP server that scrapes IIA resources and formats them as markdown files for easy consumption by AI agents. The server provides comprehensive access to:
IIA Professional Standards (1000 and 2000 series)
Implementation Guidance and IPPF framework
Specialized Topics (cybersecurity, ESG, risk assessment, etc.)
Glossary and Templates
Recent Updates and changes
Architecture
Components
Scraper (
scraper.ts
) - Web scraping tool that downloads IIA resourcesMCP Server (
iia_mcp_server.ts
) - Serves scraped content via Model Context ProtocolStructured Output - Well-organized markdown files following IIA documentation patterns
Directory Structure
Following the structure defined in Structure.txt
:
Getting Started
Prerequisites
Node.js (v18+)
TypeScript
npm
Installation
Usage
1. Scrape IIA Resources
This will:
Create the
iia-resources/
directory structureDownload IIA content from their website
Convert HTML to markdown with proper frontmatter
Organize files according to the standardized structure
2. Run the MCP Server
Configuration
Environment variables:
IIA_REPO_PATH
- Path to IIA resources directory (default:./iia-resources
)IIA_GITHUB_REPO
- Repository reference (default:organization/iia-resources
)
MCP Server Features
Resources
Dynamic document serving from markdown files
Categorized access to all IIA content types
Metadata-rich responses with source URLs
Tools
search_documents - Search by keywords, standard numbers, or topics
get_standard_details - Retrieve specific standard information
get_related_documents - Find related content for topics
validate_compliance - Check scenarios against IIA standards
get_document_updates - Track recent changes and updates
Advanced Features
Content Caching for performance
Relevance Scoring for search results
Standard Number Detection for compliance validation
YAML Frontmatter Parsing for rich metadata
Development
File Formats
All scraped content includes YAML frontmatter:
Code Standards
TypeScript with strict type checking
Async/await patterns throughout
Error handling and retry logic
Respectful scraping with rate limiting
Usage with AI Assistants
This MCP server enables AI assistants to:
Reference IIA Standards accurately in audit guidance
Validate Compliance scenarios against official standards
Search Documentation by topic, keyword, or standard number
Stay Current with the latest IIA updates and changes
Access Templates for audit programs and reports
Research and Education
This project is designed for research and educational purposes, providing structured access to public IIA resources for academic study and professional development in internal auditing.
License
MIT License - See LICENSE file for details.
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
Support
For issues and questions:
Check existing GitHub issues
Create new issues with detailed descriptions
Include error logs and environment details
Tools
A Model Context Protocol server that provides AI assistants with access to Institute of Internal Auditors professional standards, guidance documents, and resources for accurate audit guidance and compliance validation.
Related MCP Servers
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -331
- -securityAlicense-qualityA Model Context Protocol server that allows AI assistants to invoke and interact with Integrator automation workflows through an API connection.Last updated -1MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to interact with iOS simulators, perform accessibility testing, manage apps, and automate complex iOS workflows.Last updated -27Apache 2.0