Feature/windows platform support

build-mingw.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Build script for GopherMCP with MinGW on Cygwin
+# Usage: ./build-mingw.sh [clean|release|debug]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BUILD_DIR="${SCRIPT_DIR}/build-mingw"
+BUILD_TYPE="${1:-Release}"
+
+# Handle clean option
+if [ "$1" == "clean" ]; then
+    echo "Cleaning build directory..."
+    rm -rf "${BUILD_DIR}"
+    echo "Done."
+    exit 0
+fi
+
+# Set build type
+if [ "$1" == "debug" ]; then
+    BUILD_TYPE="Debug"
+elif [ "$1" == "release" ]; then
+    BUILD_TYPE="Release"
+fi
+
+echo "========================================"
+echo "GopherMCP MinGW Build Script"
+echo "========================================"
+echo "Build type: ${BUILD_TYPE}"
+echo "Build directory: ${BUILD_DIR}"
+echo ""
+
+# Create build directory
+mkdir -p "${BUILD_DIR}"
+cd "${BUILD_DIR}"
+
+# Configure with CMake
+echo "Configuring with CMake..."
+cmake -DCMAKE_TOOLCHAIN_FILE="${SCRIPT_DIR}/cmake/mingw-w64-toolchain.cmake" \
+      -DCMAKE_BUILD_TYPE="${BUILD_TYPE}" \
+      -DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
+      -DBUILD_EXAMPLES=ON \
+      -DBUILD_TESTS=OFF \
+      -DBUILD_SHARED_LIBS=OFF \
+      -DBUILD_STATIC_LIBS=ON \
+      "${SCRIPT_DIR}"
+
+# Build
+echo ""
+echo "Building mcp_example_server..."
+cmake --build . --target mcp_example_server -j$(nproc 2>/dev/null || echo 4)
+
+echo ""
+echo "========================================"
+echo "Build complete!"
+echo "========================================"
+echo "Executable: ${BUILD_DIR}/examples/mcp/mcp_example_server.exe"
+echo ""
+echo "To run: ${BUILD_DIR}/examples/mcp/mcp_example_server.exe --help"

cmake/mingw-w64-toolchain.cmake

@@ -0,0 +1,73 @@
+# MinGW-w64 Cross-Compilation Toolchain for Cygwin
+# Usage: cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/mingw-w64-toolchain.cmake ..
+
+set(CMAKE_SYSTEM_NAME Windows)
+set(CMAKE_SYSTEM_PROCESSOR x86_64)
+
+# Specify the cross compilers
+set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc.exe)
+set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++.exe)
+set(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres.exe)
+set(CMAKE_AR x86_64-w64-mingw32-ar.exe)
+set(CMAKE_RANLIB x86_64-w64-mingw32-ranlib.exe)
+
+# MinGW sysroot paths
+set(MINGW_SYSROOT /usr/x86_64-w64-mingw32/sys-root/mingw)
+
+# Target environment - Cygwin's MinGW sysroot
+set(CMAKE_FIND_ROOT_PATH
+    ${MINGW_SYSROOT}
+    /usr/x86_64-w64-mingw32
+)
+
+# Search for programs in the build host directories
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+# Search for libraries and headers in the target directories
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
+
+# OpenSSL paths for MinGW
+set(OPENSSL_ROOT_DIR ${MINGW_SYSROOT})
+set(OPENSSL_INCLUDE_DIR ${MINGW_SYSROOT}/include)
+set(OPENSSL_CRYPTO_LIBRARY ${MINGW_SYSROOT}/lib/libcrypto.dll.a)
+set(OPENSSL_SSL_LIBRARY ${MINGW_SYSROOT}/lib/libssl.dll.a)
+
+# yaml-cpp paths for MinGW
+set(yaml-cpp_DIR ${MINGW_SYSROOT}/lib/cmake/yaml-cpp)
+set(YAML_CPP_INCLUDE_DIR ${MINGW_SYSROOT}/include)
+set(YAML_CPP_LIBRARIES ${MINGW_SYSROOT}/lib/libyaml-cpp.dll.a)
+
+# libevent paths for MinGW
+set(LIBEVENT_INCLUDE_DIRS ${MINGW_SYSROOT}/include)
+set(LIBEVENT_LIBRARIES
+    ${MINGW_SYSROOT}/lib/libevent.dll.a
+    ${MINGW_SYSROOT}/lib/libevent_core.dll.a
+)
+
+# fmt library paths
+set(fmt_DIR ${MINGW_SYSROOT}/lib/cmake/fmt)
+
+# pkg-config path for MinGW packages
+set(ENV{PKG_CONFIG_PATH} "${MINGW_SYSROOT}/lib/pkgconfig")
+set(PKG_CONFIG_EXECUTABLE /usr/bin/x86_64-w64-mingw32-pkg-config)
+
+# Additional include/library paths
+set(CMAKE_INCLUDE_PATH ${MINGW_SYSROOT}/include)
+set(CMAKE_LIBRARY_PATH ${MINGW_SYSROOT}/lib)
+set(CMAKE_PREFIX_PATH ${MINGW_SYSROOT})
+
+# Windows platform definitions
+set(WIN32 TRUE)
+set(MINGW TRUE)
+add_definitions(-D_WIN32 -DWIN32 -D_WINDOWS -DMINGW)
+
+# Ensure Windows socket libraries are linked
+link_libraries(ws2_32 mswsock)
+
+# Disable features that may cause issues with cross-compilation
+set(CMAKE_CROSSCOMPILING TRUE)
+
+# Static linking of libgcc and libstdc++ for easier distribution
+set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static-libgcc -static-libstdc++")
+set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -static-libgcc -static-libstdc++")

examples/mcp/CMakeLists.txt

@@ -47,4 +47,11 @@ install(TARGETS mcp_example_client mcp_example_server mcp_config_example_server
 install(FILES
     ../configs/mcp_server_example.json
     DESTINATION share/mcp/examples/configs
-)
+)
+
+# Windows-specific libraries
+if(WIN32)
+    target_link_libraries(mcp_example_client ws2_32 mswsock)
+    target_link_libraries(mcp_example_server ws2_32 mswsock)
+    target_link_libraries(mcp_config_example_server ws2_32 mswsock)
+endif()

examples/mcp/mcp_example_server.cc

@@ -94,10 +94,16 @@
 #include <fstream>
 #include <iostream>
 #include <mutex>
-#include <signal.h>
 #include <sstream>
 #include <thread>
+
+// Platform-specific includes for signal/shutdown handling
+#ifdef _WIN32
+#include <windows.h>
+#else
+#include <signal.h>
 #include <unistd.h>  // for _exit
+#endif
 
 #include "mcp/json/json_bridge.h"
 #include "mcp/server/mcp_server.h"
@@ -134,6 +140,39 @@ struct ServerOptions {
   std::string http_health_path = "/health";
 };
 
+// Platform-specific shutdown handler
+#ifdef _WIN32
+// Windows Console Control Handler
+BOOL WINAPI ConsoleCtrlHandler(DWORD ctrlType) {
+  switch (ctrlType) {
+    case CTRL_C_EVENT:
+    case CTRL_BREAK_EVENT:
+    case CTRL_CLOSE_EVENT:
+    case CTRL_SHUTDOWN_EVENT:
+      std::cerr << "\n[INFO] Received console control event " << ctrlType
+                << ", initiating graceful shutdown..." << std::endl;
+
+      // Set the shutdown flag
+      g_shutdown = true;
+
+      // Notify the shutdown monitor thread
+      g_shutdown_cv.notify_all();
+
+      // For safety, if we receive multiple signals, force exit
+      static std::atomic<int> signal_count(0);
+      signal_count++;
+      if (signal_count > 1) {
+        std::cerr << "\n[INFO] Force shutdown after multiple signals..."
+                  << std::endl;
+        ExitProcess(0);
+      }
+      return TRUE;
+    default:
+      return FALSE;
+  }
+}
+#else
+// Unix signal handler
 void signal_handler(int signal) {
   // Signal handlers should do minimal work
   // Just set the flag and notify - actual shutdown happens in main thread
@@ -158,6 +197,7 @@ void signal_handler(int signal) {
     _exit(0);
   }
 }
+#endif
 
 void printUsage(const char* program) {
   std::cerr << "USAGE: " << program << " [options]\n\n";
@@ -847,9 +887,13 @@ void printStatistics(const McpServer& server) {
 }
 
 int main(int argc, char* argv[]) {
-  // Install signal handlers
+  // Install platform-specific signal/shutdown handlers
+#ifdef _WIN32
+  SetConsoleCtrlHandler(ConsoleCtrlHandler, TRUE);
+#else
   signal(SIGINT, signal_handler);
   signal(SIGTERM, signal_handler);
+#endif
 
   // Parse command-line options
   ServerOptions options = parseArguments(argc, argv);

include/mcp/event/event_loop.h

@@ -9,11 +9,24 @@
 #include <thread>
 #include <vector>
 
+#ifdef _WIN32
+#include <winsock2.h>
+#endif
+
 #include "mcp/core/compat.h"
 
 namespace mcp {
 namespace event {
 
+// Platform-specific socket/fd type for event monitoring
+// On Windows, socket handles are SOCKET type
+// On Unix/Linux, file descriptors are 32-bit int
+#ifdef _WIN32
+using os_fd_t = SOCKET;
+#else
+using os_fd_t = int;
+#endif
+
 // Forward declaration
 class WatermarkFactory {
  public:
@@ -84,11 +97,12 @@ enum class FileTriggerType {
 
 // Determine platform-preferred event type
 constexpr FileTriggerType determinePlatformPreferredEventType() {
-#if defined(WIN32) || defined(_WIN32) || defined(__WIN32__) || \
-    defined(FORCE_LEVEL_EVENTS)
-  // Windows doesn't support native edge triggers, use emulated
-  // FORCE_LEVEL_EVENTS allows testing Windows behavior on POSIX
-  return FileTriggerType::EmulatedEdge;
+#if defined(WIN32) || defined(_WIN32) || defined(__WIN32__)
+  // Windows select() only supports level-triggered mode
+  return FileTriggerType::Level;
+#elif defined(FORCE_LEVEL_EVENTS)
+  // FORCE_LEVEL_EVENTS allows testing level-triggered behavior on POSIX
+  return FileTriggerType::Level;
 #elif defined(__APPLE__) || defined(__FreeBSD__)
   // macOS/BSD: Use level-triggered to avoid issues
   // Edge-triggered with EV_CLEAR causes problems with our event handling
@@ -309,8 +323,10 @@ class Dispatcher : public DispatcherBase {
 
   /**
    * Create a file event that monitors a file descriptor.
+   * @param fd Platform-specific socket/fd (os_fd_t: int on Unix, uintptr_t on
+   * Windows)
    */
-  virtual FileEventPtr createFileEvent(int fd,
+  virtual FileEventPtr createFileEvent(os_fd_t fd,
                                        FileReadyCb cb,
                                        FileTriggerType trigger,
                                        uint32_t events) = 0;

include/mcp/event/libevent_dispatcher.h

@@ -18,6 +18,15 @@ namespace event {
 // Rename to avoid conflict with struct event
 using libevent_event = struct event;
 
+// Use libevent's socket type for callback signature compatibility.
+// On Windows, libevent uses intptr_t (SOCKET), on POSIX it uses int.
+#ifdef _WIN32
+#include <event2/util.h>
+using libevent_socket_t = evutil_socket_t;
+#else
+using libevent_socket_t = int;
+#endif
+
 /**
  * @brief Libevent-based implementation of the Dispatcher interface
  *
@@ -40,7 +49,7 @@ class LibeventDispatcher : public Dispatcher {
   void registerWatchdog(const WatchDogSharedPtr& watchdog,
                         std::chrono::milliseconds min_touch_interval) override;
 
-  FileEventPtr createFileEvent(int fd,
+  FileEventPtr createFileEvent(os_fd_t fd,
                                FileReadyCb cb,
                                FileTriggerType trigger,
                                uint32_t events) override;
@@ -87,7 +96,7 @@ class LibeventDispatcher : public Dispatcher {
   class FileEventImpl : public FileEvent {
    public:
     FileEventImpl(LibeventDispatcher& dispatcher,
-                  int fd,
+                  os_fd_t fd,
                   FileReadyCb cb,
                   FileTriggerType trigger,
                   uint32_t events);
@@ -99,13 +108,13 @@ class LibeventDispatcher : public Dispatcher {
     void registerEventIfEmulatedEdge(uint32_t event) override;
 
    private:
-    static void eventCallback(int fd, short events, void* arg);
+    static void eventCallback(libevent_socket_t fd, short events, void* arg);
     void assignEvents(uint32_t events);
     void updateEvents(uint32_t events);
     void mergeInjectedEventsAndRunCb(uint32_t events);
 
     LibeventDispatcher& dispatcher_;
-    int fd_;
+    os_fd_t fd_;
     FileReadyCb cb_;
     FileTriggerType trigger_;
     libevent_event* event_;
@@ -129,7 +138,7 @@ class LibeventDispatcher : public Dispatcher {
     bool enabled() override;
 
    private:
-    static void timerCallback(int fd, short events, void* arg);
+    static void timerCallback(libevent_socket_t fd, short events, void* arg);
 
     LibeventDispatcher& dispatcher_;
     TimerCb cb_;
@@ -165,7 +174,7 @@ class LibeventDispatcher : public Dispatcher {
     ~SignalEventImpl() override;
 
    private:
-    static void signalCallback(int fd, short events, void* arg);
+    static void signalCallback(libevent_socket_t fd, short events, void* arg);
 
     LibeventDispatcher& dispatcher_;
     int signal_num_;
@@ -185,7 +194,7 @@ class LibeventDispatcher : public Dispatcher {
   void runDeferredDeletes();
   void touchWatchdog();
   void initializeLibevent();
-  static void postWakeupCallback(int fd, short events, void* arg);
+  static void postWakeupCallback(libevent_socket_t fd, short events, void* arg);
 
   // Member variables
   const std::string name_;
@@ -196,7 +205,7 @@ class LibeventDispatcher : public Dispatcher {
   // Post callback handling
   std::mutex post_mutex_;
   std::queue<PostCb> post_callbacks_;
-  int wakeup_fd_[2];  // Pipe for waking up event loop
+  libevent_socket_t wakeup_fd_[2];  // Pipe for waking up event loop
   libevent_event* wakeup_event_;
 
   // Deferred deletion

include/mcp/filter/filter_event.h

@@ -63,6 +63,10 @@ enum class FilterEventType {
  *
  * Severity classification for filtering and prioritization of events.
  */
+// Windows defines ERROR as a macro in wingdi.h, undef it to avoid conflict
+#ifdef ERROR
+#undef ERROR
+#endif
 enum class FilterEventSeverity {
   TRACE = 0,    ///< Trace-level diagnostic information
   DEBUG = 1,    ///< Debug-level information

include/mcp/http/http_parser.h

@@ -47,6 +47,10 @@ enum class HttpStatusCode : uint16_t {
 };
 
 // HTTP methods
+// Note: Windows defines DELETE as a macro in winnt.h, so we need to undefine it
+#ifdef DELETE
+#undef DELETE
+#endif
 enum class HttpMethod {
   GET,
   POST,