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-mcp
Install dependencies:
npm install
Build the project:
npm run build
Start the server:
npm start

🔧 Available Tools

Tool	Description	Parameters
`search_msfs_docs`	🔍 Search MSFS SDK documentation	`query`, `category`, `limit`
`get_doc_content`	📄 Retrieve detailed content	`url`, `section`
`list_categories`	📚 Show all search categories	-
`list_category_items`	📋 List items per category	`category`
`natural_language_query`	🧠 Natural language queries	`query`

🏷️ Search Categories

contents - 📖 Main documentation content
index - 📇 Documentation index entries
glossary - 📚 Technical terms and definitions
all - 🌐 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	`npm run build`
👀 Dev	Watch mode development	`npm run dev`
🚀 Start	Start MCP server	`npm start`
🔍 Type Check	TypeScript validation	`npx tsc --noEmit`

📚 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 features
fix: - Bug fixes
docs: - Documentation updates
refactor: - Code refactoring
test: - 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! ✈️

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

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.

Tools

A modern MCP server that provides fast, structured access to Microsoft Flight Simulator SDK documentation through natural language and structured queries.

Related MCP Servers

FlightRadar MCP Server
Cyreslab-AI
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.
Last updated -
3
2,548
6
JavaScript
MIT License
Google-Flights-MCP-Server
opspawn
-
security
A
license
-
quality
This 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 -
11
Python
MIT License
MCP Specification Server
MCPJam
A
security
F
license
A
quality
Provides complete access to Model Context Protocol documentation through an MCP server, allowing LLMs to query specific sections like 'Tools', 'Resources', and 'Authorization' to retrieve comprehensive protocol specifications.
Last updated -
1
2
5
JavaScript
Aviationstack MCP Server
Pradumnasaraf
A
security
A
license
A
quality
An MCP server using the AviationStack API to fetch real-time flight data, including airline flights, airport schedules, future flights and aircraft types.
Last updated -
7
4
Python
MIT License

View all related MCP servers

MSFS SDK MCP Server