A
securityA
licenseA
qualityA Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.
Last updated -
3
3,796
6
MIT License
Used as an HTML parser to extract and process content from MSFS SDK documentation pages
Serves as the runtime environment for the MSFS SDK MCP server
Optional integration for browser automation to enhance documentation retrieval capabilities
Used as the primary programming language for building the MSFS SDK MCP server
MSFS SDK MCP Server
A modern, performant MCP server for fast, structured access to Microsoft Flight Simulator SDK documentation via natural language and structured queries.
🚀 Features
⚡️ Real-time documentation search in the official MSFS SDK documentation
📚 Multiple search categories: contents, index, glossary, all
🧠 Natural language processing: queries like "Search livery op msfs sdk"
📊 Structured results: titles, URLs, descriptions, categories
📄 Detailed content retrieval from specific documentation pages
🔌 Full MCP compatibility with AI assistants and tools
💾 Embedded data: no external files needed
🛡️ Robust error handling and logging
🛠️ Tech Stack
Runtime: Node.js 18+
Language: TypeScript 5.0
Framework: Model Context Protocol (MCP)
HTTP Client: node-fetch
HTML Parser: Cheerio
Browser Automation: Puppeteer (optional)
Build Tool: TypeScript Compiler
📋 Requirements
Node.js 18.x or higher
npm 8.x or higher
TypeScript 5.x
🚀 Setup
Clone the repository:
git clone https://github.com/yourusername/msfs-sdk-mcp.git cd msfs-sdk-mcpInstall dependencies:
npm installBuild the project:
npm run buildStart the server:
npm start
🔧 Available Tools
Tool | Description | Parameters |
| 🔍 Search MSFS SDK documentation |
,
,
|
| 📄 Retrieve detailed content |
,
|
| 📚 Show all search categories | - |
| 📋 List items per category |
|
| 🧠 Natural language queries |
|
🏷️ Search Categories
contents- 📖 Main documentation contentindex- 📇 Documentation index entriesglossary- 📚 Technical terms and definitionsall- 🌐 Search across all categories (default: index)
🔌 Integration with AI Assistants
This server works with MCP-compatible AI assistants such as:
🤖 Claude Desktop - Official MCP support
🌊 Windsurf IDE - Built-in MCP integration
🔧 Other MCP clients - All MCP-compatible tools
⚙️ Configuration Example
{
"mcpServers": {
"msfs-sdk": {
"command": "node",
"args": ["path/to/msfs-sdk-mcp/dist/index.js"]
}
}
}
📁 Project Structure
msfs-sdk-mcp/
├── 📄 package.json # Dependencies and scripts
├── 📄 tsconfig.json # TypeScript configuration
├── 📄 README.md # Project documentation
├── 📄 LICENSE # MIT License
├── 📂 src/
│ ├── 📄 index.ts # 🚀 Main MCP server
│ └── 📂 services/
│ ├── 📄 documentationService.ts # 🔍 Search logic
│ └── 📄 naturalLanguageService.ts # 🧠 NLP processing
└── 📂 dist/ # 🏗️ Compiled JavaScript
🧪 Development & Scripts
Script | Description | Command |
🏗️ Build | Compile TypeScript |
|
👀 Dev | Watch mode development |
|
🚀 Start | Start MCP server |
|
🔍 Type Check | TypeScript validation |
|
📚 API Reference
📈 Tool Examples
🔍 search_msfs_docs
{
"name": "search_msfs_docs",
"arguments": {
"query": "livery",
"category": "all",
"limit": 10
}
}
📋 list_category_items
{
"name": "list_category_items",
"arguments": {
"category": "glossary"
}
}
📄 get_doc_content
{
"name": "get_doc_content",
"arguments": {
"url": "https://docs.flightsimulator.com/html/...",
"section": "overview"
}
}
🌐 Search URL Format
https://docs.flightsimulator.com/html/Introduction/Introduction.htm?rhsearch={query}&agt={category}
Parameters:
{query}- 🔍 Search term (URL-encoded){category}- 🏷️ Optional category (index,glossary, or empty for contents)
📊 Response Format
{
"content": [
{
"type": "text",
"text": "**Title**\n- Category: category\n- URL: url\n- Description: description"
}
]
}
🤝 Contributing
🍴 Fork this repository
🌱 Create a feature branch:
git checkout -b feature-name✨ Implement and test your changes
📝 Commit with clear message:
git commit -am 'Add new feature'🚀 Push to your branch:
git push origin feature-name📩 Open a Pull Request
📅 Commit Convention
feat:- New featuresfix:- Bug fixesdocs:- Documentation updatesrefactor:- Code refactoringtest:- Test additions
📄 License
MIT License – See LICENSE file for details.
📞 Support & Contact
🐛 Issues: GitHub Issues
📚 MSFS SDK Docs: Official documentation
❓ New issue? Provide clear information and reproducible steps
📅 Changelog
v1.0.0 - 🎉 Initial Release
✨ Initial release - Complete MCP server implementation
🔍 Real-time documentation search - Fast access to MSFS SDK docs
📚 Multiple search categories - Contents, index, glossary support
🧠 Natural language processing - Intuitive query processing
🔌 MCP standard support - Full compatibility
💾 Embedded data - No external dependencies
⚠️ Disclaimer
This is an unofficial tool, not affiliated with Microsoft or Microsoft Flight Simulator. Provides access to public documentation via the official MSFS SDK website.
🚀 Happy Flying! ✈️
© 90barricade93 - aero-ai-solutions.com
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A modern MCP server that provides fast, structured access to Microsoft Flight Simulator SDK documentation through natural language and structured queries.
Related MCP Servers
- -securityAlicense-qualityThis MCP server allows an AI assistants to search for flight information online using Google Flights. It can find flights for specific dates or search through a range of dates to find all options or just the cheapest ones available.Last updated -15MIT License
- AsecurityAlicenseAqualityAn MCP server using the AviationStack API to fetch real-time flight data, including airline flights, airport schedules, future flights and aircraft types.Last updated -79MIT License
- -securityAlicense-qualityAn MCP server that enables connection to Microsoft SQL Server databases, providing tools for schema inspection and querying through standardized interfaces.Last updated -MIT License