cf-mcp 0.15.5 → 0.16.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24dc9506e66606bf2146f17aad18cae3a5c1e0a021b5a9d1a1cfd7d3fa08e730
-  data.tar.gz: 89faa9c9e1fbae4fad23b4b2bf0d9a42b671d214865261c13824d71c2b5aae04
+  metadata.gz: 8616f673c57b67cd09602a2b49611c030fc058d63f1701dd2cec2cff2c04d4ad
+  data.tar.gz: abc2b55c27a9f4ace220d5fd9d013cb5944c02d8bd6f43106be141ac05aaa208
 SHA512:
-  metadata.gz: 8ee6f579771136d11d7f748fb1b0d4cc851765bb7c8fc771cf8b3e4e951a86e6b0b33ff719c14cbf152fa72b1851094fa484d23353c0e67ca5ec00d3e0ae999b
-  data.tar.gz: 755ce736815559983d1a5ca8b593119b184661a30668dca28551e88a9e544af67553d2519b76359e6bde9b33aac2fa5e7aedbed5498b0d8a7da6af34b0e5d1bc
+  metadata.gz: 7587ed21fd3fe5e3f81a7fd574cc32afc3da7c69b7c9869241508ad8a3f477ec813297f1d893b0dba5c3c9ccc4411773adacce35eeb8e15a936328f613d55186
+  data.tar.gz: 02e5f832b1c52dc25ec415d362585e7f104a526a24e7454af38192f48d60abc209c7f91175b60dd5759b0dc1670508fdf16ad61fa7db4aebe25edf7f406d984a

data/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.2] - 2026-01-31
+
+### Fixed
+
+- Enum entries now correctly prefixed with `CF_` (e.g., `CF_KEY_SPACE` instead of `KEY_SPACE`) to match the CF_ENUM macro expansion
+
+## [0.16.1] - 2026-01-31
+
+### Fixed
+
+- Fix broken logo image path in dashboard (use favicon.svg instead of non-existent logo.svg)
+
+### Changed
+
+- Add workflow_dispatch trigger to fly-deploy.yml for manual deployments
+
+## [0.16.0] - 2026-01-26
+
+### Changed
+
+- **Refactored tool loading with Index singleton** - Index is now a singleton, eliminating duplicate schema definitions and simplifying tool initialization
+- Tool classes now use `Index.instance.categories` directly in schema definitions instead of requiring runtime configuration
+- Removed `TOOLS` constant and `configure_tool_schemas` method from Server
+- Tools use autoload for lazy loading, ensuring they see populated categories at load time
+
 ## [0.15.5] - 2026-01-26
 
 ### Changed
@@ -236,6 +261,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `cf_list_category` - List items by category
   - `cf_get_details` - Get full documentation by name
 
+[0.16.2]: https://github.com/pusewicz/cf-mcp/compare/v0.16.1...v0.16.2
+[0.16.1]: https://github.com/pusewicz/cf-mcp/compare/v0.16.0...v0.16.1
+[0.16.0]: https://github.com/pusewicz/cf-mcp/compare/v0.15.5...v0.16.0
 [0.15.5]: https://github.com/pusewicz/cf-mcp/compare/v0.15.4...v0.15.5
 [0.15.4]: https://github.com/pusewicz/cf-mcp/compare/v0.15.3...v0.15.4
 [0.15.3]: https://github.com/pusewicz/cf-mcp/compare/v0.15.2...v0.15.3

data/Manifest.txt

@@ -35,10 +35,7 @@ lib/cf/mcp/tools/list_topics.rb
 lib/cf/mcp/tools/member_search.rb
 lib/cf/mcp/tools/parameter_search.rb
 lib/cf/mcp/tools/response_helpers.rb
-lib/cf/mcp/tools/search_enums.rb
-lib/cf/mcp/tools/search_functions.rb
 lib/cf/mcp/tools/search_result_formatter.rb
-lib/cf/mcp/tools/search_structs.rb
 lib/cf/mcp/tools/search_tool.rb
 lib/cf/mcp/topic_parser.rb
 lib/cf/mcp/version.rb

data/Rakefile

@@ -9,7 +9,7 @@ require "standard/rake"
 
 desc "Generate Manifest.txt from git ls-files"
 task :manifest do
-  ignore_patterns = %w[bin/ Gemfile .gitignore test/ .github/ .standard.yml cf-mcp.gemspec .ruby-version CLAUDE.md AGENTS.md fly.toml Procfile Dockerfile .dockerignore .claude/]
+  ignore_patterns = %w[bin/ Gemfile .gitignore test/ .github/ .standard.yml cf-mcp.gemspec .ruby-version CLAUDE.md AGENTS.md fly.toml Procfile Dockerfile .dockerignore .claude/ .mcp.json]
 
   files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
     ls.readlines("\x0", chomp: true)

data/lib/cf/mcp/index.rb

@@ -1,11 +1,19 @@
 # frozen_string_literal: true
 
+require "singleton"
+
 module CF
   module MCP
     class Index
+      include Singleton
+
       attr_reader :items, :by_type, :by_category, :topic_references
 
       def initialize
+        reset!
+      end
+
+      def reset!
         @items = {}
         @by_type = {
           function: [],

data/lib/cf/mcp/index_builder.rb

@@ -18,7 +18,8 @@ module CF
 
       def build
         parser = Parser.new
-        index = Index.new
+        index = Index.instance
+        index.reset!
 
         parser.parse_directory(headers_path).each do |item|
           index.add(item)

data/lib/cf/mcp/parser.rb

@@ -236,7 +236,8 @@ module CF
         # Find the #define block with CF_ENUM macros
         # Pattern: /* @entry description */ followed by CF_ENUM(NAME, VALUE)
         content.scan(%r{/\*\s*@entry\s+(.*?)\s*\*/\s*\\?\s*CF_ENUM\s*\(\s*(\w+)\s*,\s*([^)]*)\)}m) do |description, name, value|
-          entries << Models::EnumDoc::Entry.new(name.strip, value.strip, description.strip)
+          # CF_ENUM(K, V) expands to CF_##K = V, so add CF_ prefix
+          entries << Models::EnumDoc::Entry.new("CF_#{name.strip}", value.strip, description.strip)
         end
 
         entries

data/lib/cf/mcp/server.rb

@@ -1,37 +1,12 @@
 # frozen_string_literal: true
 
 require "mcp"
-require_relative "tools/search_tool"
-require_relative "tools/search_functions"
-require_relative "tools/search_structs"
-require_relative "tools/search_enums"
-require_relative "tools/list_category"
-require_relative "tools/get_details"
-require_relative "tools/find_related"
-require_relative "tools/parameter_search"
-require_relative "tools/member_search"
-require_relative "tools/list_topics"
-require_relative "tools/get_topic"
 
 module CF
   module MCP
     class Server
       attr_reader :server, :index
 
-      TOOLS = [
-        Tools::SearchTool,
-        Tools::SearchFunctions,
-        Tools::SearchStructs,
-        Tools::SearchEnums,
-        Tools::ListCategory,
-        Tools::GetDetails,
-        Tools::FindRelated,
-        Tools::ParameterSearch,
-        Tools::MemberSearch,
-        Tools::ListTopics,
-        Tools::GetTopic
-      ].freeze
-
       CORS_HEADERS = {
         "access-control-allow-origin" => "*",
         "access-control-allow-methods" => "GET, POST, DELETE, OPTIONS",
@@ -65,6 +40,7 @@ module CF
 
       def initialize(index)
         @index = index
+
         configuration = ::MCP::Configuration.new(protocol_version: PROTOCOL_VERSION)
         @server = ::MCP::Server.new(
           name: "cf-mcp",
@@ -76,7 +52,16 @@ module CF
             ::MCP::Icon.new(src: "#{WEBSITE_URL}/favicon.svg", mime_type: "image/svg+xml", sizes: ["any"]),
             ::MCP::Icon.new(src: "#{WEBSITE_URL}/favicon-96x96.png", mime_type: "image/png", sizes: ["96x96"])
           ],
-          tools: TOOLS,
+          tools: [
+            Tools::SearchTool,
+            Tools::ListCategory,
+            Tools::GetDetails,
+            Tools::FindRelated,
+            Tools::ParameterSearch,
+            Tools::MemberSearch,
+            Tools::ListTopics,
+            Tools::GetTopic
+          ],
           resources: build_topic_resources(index)
         )
         @server.server_context = {index: index}
@@ -100,7 +85,7 @@ module CF
 
         landing_page = build_landing_page
         index = @index
-        tools = TOOLS
+        tools = @server.tools.values
         cors_headers = CORS_HEADERS
         public_dir = PUBLIC_DIR
 

data/lib/cf/mcp/templates/index.erb

@@ -15,7 +15,7 @@
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
 </head>
 <body>
-  <h1><img src="/logo.svg" alt="CF Logo" class="title-logo">CF::MCP <small style="font-size: 0.5em; color: #8b949e;">v<%= version %></small></h1>
+  <h1><img src="/favicon.svg" alt="CF Logo" class="title-logo">CF::MCP <small style="font-size: 0.5em; color: #8b949e;">v<%= version %></small></h1>
   <p>MCP (Model Context Protocol) server for the <a href="https://github.com/RandyGaul/cute_framework">Cute Framework</a>, a C/C++ 2D game framework.</p>
 
   <div class="stats">

data/lib/cf/mcp/tools/find_related.rb

@@ -32,8 +32,7 @@ module CF
         )
 
         def self.call(name:, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           item = index.find(name)
           return text_response("Not found: '#{name}'") unless item

data/lib/cf/mcp/tools/get_details.rb

@@ -34,8 +34,7 @@ module CF
         NAMING_TIP = "**Tip:** Cute Framework uses `cf_` prefix for functions and `CF_` prefix for types (structs/enums)."
 
         def self.call(name:, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           item = index.find(name)
 

data/lib/cf/mcp/tools/get_topic.rb

@@ -32,8 +32,7 @@ module CF
         )
 
         def self.call(name:, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           topic = index.find(name)
 

data/lib/cf/mcp/tools/list_category.rb

@@ -18,7 +18,7 @@ module CF
         input_schema(
           type: "object",
           properties: {
-            category: {type: "string", description: "Category name (e.g., 'app', 'sprite', 'graphics'). Leave empty to list all categories."},
+            category: {type: "string", enum: Index.instance.categories, description: "Category name. Leave empty to list all categories."},
             type: {type: "string", enum: ["function", "struct", "enum"], description: "Optional: filter by item type"}
           }
         )
@@ -32,8 +32,7 @@ module CF
         )
 
         def self.call(category: nil, type: nil, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           if category.nil? || category.empty?
             # List all categories with counts by type

data/lib/cf/mcp/tools/list_topics.rb

@@ -32,8 +32,7 @@ module CF
         )
 
         def self.call(category: nil, ordered: false, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           topics = ordered ? index.topics_ordered : index.topics
 

data/lib/cf/mcp/tools/member_search.rb

@@ -33,8 +33,7 @@ module CF
         )
 
         def self.call(query:, limit: 20, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           pattern = Regexp.new(Regexp.escape(query), Regexp::IGNORECASE)
           results = []

data/lib/cf/mcp/tools/parameter_search.rb

@@ -37,8 +37,7 @@ module CF
         )
 
         def self.call(type:, direction: "both", server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           pattern = Regexp.new(Regexp.escape(type), Regexp::IGNORECASE)
           input_matches = []

data/lib/cf/mcp/tools/search_tool.rb

@@ -22,7 +22,7 @@ module CF
           properties: {
             query: {type: "string", description: "Search query (searches in name, description, and remarks)"},
             type: {type: "string", enum: ["function", "struct", "enum", "topic"], description: "Optional: filter by item type"},
-            category: {type: "string", description: "Optional: filter by category (e.g., 'app', 'sprite', 'graphics')"},
+            category: {type: "string", enum: Index.instance.categories, description: "Optional: filter by category"},
             limit: {type: "integer", description: "Maximum number of results to return (default: 20)"}
           },
           required: ["query"]
@@ -36,21 +36,40 @@ module CF
           open_world_hint: false
         )
 
-        DETAILS_TIP = "**Tip:** Use `get_details` for API items or `get_topic` for topic guides to get full documentation."
+        DETAILS_TIPS = {
+          "function" => "**Tip:** Use `get_details` with an exact name to get full documentation including signature, parameters, and examples.",
+          "struct" => "**Tip:** Use `get_details` with an exact name to get full documentation including members and examples.",
+          "enum" => "**Tip:** Use `get_details` with an exact name to get full documentation including values and examples.",
+          "topic" => "**Tip:** Use `get_topic` with an exact name to get the full topic guide.",
+          nil => "**Tip:** Use `get_details` for API items or `get_topic` for topic guides to get full documentation."
+        }.freeze
+
+        TYPE_LABELS = {
+          "function" => "function(s)",
+          "struct" => "struct(s)",
+          "enum" => "enum(s)",
+          "topic" => "topic(s)",
+          nil => "result(s)"
+        }.freeze
 
         def self.call(query:, type: nil, category: nil, limit: 20, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
+          index = Index.instance
 
           results = index.search(query, type: type, category: category, limit: limit)
 
+          filter_suggestion = if type
+            "To find more results, narrow your search with a `category` filter."
+          else
+            "To find more results, narrow your search with `type` or `category` filters."
+          end
+
           text = format_search_results(
             results,
             query: query,
-            type_label: "result(s)",
+            type_label: TYPE_LABELS[type],
             limit: limit,
-            details_tip: DETAILS_TIP,
-            filter_suggestion: "To find more results, narrow your search with `type` or `category` filters."
+            details_tip: DETAILS_TIPS[type],
+            filter_suggestion: filter_suggestion
           )
           text_response(text)
         end

data/lib/cf/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module CF
   module MCP
-    VERSION = "0.15.5"
+    VERSION = "0.16.2"
   end
 end

data/lib/cf/mcp.rb

@@ -20,5 +20,16 @@ module CF
     def self.root
       @root ||= Pathname.new(File.expand_path("../..", __dir__))
     end
+
+    module Tools
+      autoload :SearchTool, "cf/mcp/tools/search_tool"
+      autoload :ListCategory, "cf/mcp/tools/list_category"
+      autoload :GetDetails, "cf/mcp/tools/get_details"
+      autoload :FindRelated, "cf/mcp/tools/find_related"
+      autoload :ParameterSearch, "cf/mcp/tools/parameter_search"
+      autoload :MemberSearch, "cf/mcp/tools/member_search"
+      autoload :ListTopics, "cf/mcp/tools/list_topics"
+      autoload :GetTopic, "cf/mcp/tools/get_topic"
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cf-mcp
 version: !ruby/object:Gem::Version
-  version: 0.15.5
+  version: 0.16.2
 platform: ruby
 authors:
 - Piotr Usewicz
@@ -125,10 +125,7 @@ files:
 - lib/cf/mcp/tools/member_search.rb
 - lib/cf/mcp/tools/parameter_search.rb
 - lib/cf/mcp/tools/response_helpers.rb
-- lib/cf/mcp/tools/search_enums.rb
-- lib/cf/mcp/tools/search_functions.rb
 - lib/cf/mcp/tools/search_result_formatter.rb
-- lib/cf/mcp/tools/search_structs.rb
 - lib/cf/mcp/tools/search_tool.rb
 - lib/cf/mcp/topic_parser.rb
 - lib/cf/mcp/version.rb

data/lib/cf/mcp/tools/search_enums.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "mcp"
-require_relative "response_helpers"
-require_relative "search_result_formatter"
-
-module CF
-  module MCP
-    module Tools
-      class SearchEnums < ::MCP::Tool
-        extend ResponseHelpers
-        extend SearchResultFormatter
-
-        TITLE = "Search Enums"
-
-        tool_name "search_enums"
-        title TITLE
-        description "Search Cute Framework enums"
-
-        input_schema(
-          type: "object",
-          properties: {
-            query: {type: "string", description: "Search query"},
-            category: {type: "string", description: "Optional: filter by category"},
-            limit: {type: "integer", description: "Maximum results (default: 20)"}
-          },
-          required: ["query"]
-        )
-
-        annotations(
-          title: TITLE,
-          read_only_hint: true,
-          destructive_hint: false,
-          idempotent_hint: true,
-          open_world_hint: false
-        )
-
-        DETAILS_TIP = "**Tip:** Use `get_details` with an exact name to get full documentation including values and examples."
-
-        def self.call(query:, category: nil, limit: 20, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
-
-          results = index.search(query, type: :enum, category: category, limit: limit)
-
-          text = format_search_results(
-            results,
-            query: query,
-            type_label: "enum(s)",
-            limit: limit,
-            details_tip: DETAILS_TIP,
-            filter_suggestion: "To find more results, narrow your search with a `category` filter."
-          )
-          text_response(text)
-        end
-      end
-    end
-  end
-end

data/lib/cf/mcp/tools/search_functions.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "mcp"
-require_relative "response_helpers"
-require_relative "search_result_formatter"
-
-module CF
-  module MCP
-    module Tools
-      class SearchFunctions < ::MCP::Tool
-        extend ResponseHelpers
-        extend SearchResultFormatter
-
-        TITLE = "Search Functions"
-
-        tool_name "search_functions"
-        title TITLE
-        description "Search Cute Framework functions"
-
-        input_schema(
-          type: "object",
-          properties: {
-            query: {type: "string", description: "Search query"},
-            category: {type: "string", description: "Optional: filter by category"},
-            limit: {type: "integer", description: "Maximum results (default: 20)"}
-          },
-          required: ["query"]
-        )
-
-        annotations(
-          title: TITLE,
-          read_only_hint: true,
-          destructive_hint: false,
-          idempotent_hint: true,
-          open_world_hint: false
-        )
-
-        DETAILS_TIP = "**Tip:** Use `get_details` with an exact name to get full documentation including signature, parameters, and examples."
-
-        def self.call(query:, category: nil, limit: 20, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
-
-          results = index.search(query, type: :function, category: category, limit: limit)
-
-          text = format_search_results(
-            results,
-            query: query,
-            type_label: "function(s)",
-            limit: limit,
-            details_tip: DETAILS_TIP,
-            filter_suggestion: "To find more results, narrow your search with a `category` filter."
-          )
-          text_response(text)
-        end
-      end
-    end
-  end
-end

data/lib/cf/mcp/tools/search_structs.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "mcp"
-require_relative "response_helpers"
-require_relative "search_result_formatter"
-
-module CF
-  module MCP
-    module Tools
-      class SearchStructs < ::MCP::Tool
-        extend ResponseHelpers
-        extend SearchResultFormatter
-
-        TITLE = "Search Structs"
-
-        tool_name "search_structs"
-        title TITLE
-        description "Search Cute Framework structs"
-
-        input_schema(
-          type: "object",
-          properties: {
-            query: {type: "string", description: "Search query"},
-            category: {type: "string", description: "Optional: filter by category"},
-            limit: {type: "integer", description: "Maximum results (default: 20)"}
-          },
-          required: ["query"]
-        )
-
-        annotations(
-          title: TITLE,
-          read_only_hint: true,
-          destructive_hint: false,
-          idempotent_hint: true,
-          open_world_hint: false
-        )
-
-        DETAILS_TIP = "**Tip:** Use `get_details` with an exact name to get full documentation including members and examples."
-
-        def self.call(query:, category: nil, limit: 20, server_context: {})
-          index = server_context[:index]
-          return error_response("Index not available") unless index
-
-          results = index.search(query, type: :struct, category: category, limit: limit)
-
-          text = format_search_results(
-            results,
-            query: query,
-            type_label: "struct(s)",
-            limit: limit,
-            details_tip: DETAILS_TIP,
-            filter_suggestion: "To find more results, narrow your search with a `category` filter."
-          )
-          text_response(text)
-        end
-      end
-    end
-  end
-end