cf-mcp 0.9.2

data/lib/cf/mcp/topic_parser.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+require_relative "models/topic_doc"
+
+module CF
+  module MCP
+    class TopicParser
+      # Pattern to match markdown links: [text](../category/name.md)
+      API_LINK_PATTERN = %r{\[`?([^\]]+)`?\]\(\.\./(\w+)/(\w+)\.md\)}
+
+      # Pattern to match topic links: [text](./topic_name.md) or [text](../topics/topic_name.md)
+      TOPIC_LINK_PATTERN = %r{\[([^\]]+)\]\((?:\./|\.\./topics/)(\w+)\.md\)}
+
+      # Pattern to match section headings
+      SECTION_PATTERN = /^##\s+(.+)$/
+
+      def parse_file(path)
+        content = File.read(path)
+        filename = File.basename(path, ".md")
+
+        return nil if filename == "index"
+
+        parse_topic(content, filename, File.basename(path))
+      end
+
+      def parse_directory(path)
+        topics = []
+        reading_order = parse_reading_order(File.join(path, "index.md"))
+
+        Dir.glob(File.join(path, "*.md")).each do |topic_file|
+          next if File.basename(topic_file) == "index.md"
+
+          topic = parse_file(topic_file)
+          if topic
+            topic.reading_order = reading_order[topic.name]
+            topics << topic
+          end
+        end
+
+        topics
+      end
+
+      def parse_reading_order(index_path)
+        return {} unless File.exist?(index_path)
+
+        content = File.read(index_path)
+        order = {}
+        position = 0
+
+        # Match numbered list items with topic links
+        content.scan(/^\d+\.\s+\[([^\]]+)\]\(\.\/(\w+)\.md\)/) do |_title, slug|
+          order[slug] = position
+          position += 1
+        end
+
+        order
+      end
+
+      private
+
+      def parse_topic(content, slug, source_file)
+        extract_title(content)
+        brief = extract_brief(content)
+        sections = extract_sections(content)
+
+        func_refs, struct_refs, enum_refs = extract_api_references(content)
+        topic_refs = extract_topic_references(content)
+
+        category = derive_category(slug)
+
+        Models::TopicDoc.new(
+          name: slug,
+          brief: brief,
+          category: category,
+          content: content,
+          sections: sections,
+          function_references: func_refs.uniq,
+          struct_references: struct_refs.uniq,
+          enum_references: enum_refs.uniq,
+          topic_references: topic_refs.uniq,
+          source_file: source_file
+        )
+      end
+
+      def extract_title(content)
+        content.lines.find { |line| line.start_with?("# ") }&.sub(/^#\s+/, "")&.strip
+      end
+
+      def extract_brief(content)
+        lines = content.lines
+        in_paragraph = false
+        paragraph_lines = []
+
+        lines.each do |line|
+          next if line.start_with?("#")
+
+          if line.strip.empty?
+            break if in_paragraph
+            next
+          end
+
+          in_paragraph = true
+          paragraph_lines << line.strip
+        end
+
+        # Strip markdown links but keep the text
+        paragraph_lines.join(" ").gsub(/\[([^\]]+)\]\([^)]+\)/, '\1')
+      end
+
+      def extract_sections(content)
+        sections = []
+        current_title = nil
+        current_content = []
+
+        content.lines.each do |line|
+          if line =~ SECTION_PATTERN
+            if current_title
+              sections << Models::TopicDoc::Section.new(
+                title: current_title,
+                content: current_content.join
+              )
+            end
+            current_title = ::Regexp.last_match(1).strip
+            current_content = []
+          elsif current_title
+            current_content << line
+          end
+        end
+
+        # Add last section
+        if current_title
+          sections << Models::TopicDoc::Section.new(
+            title: current_title,
+            content: current_content.join
+          )
+        end
+
+        sections
+      end
+
+      def extract_api_references(content)
+        func_refs = []
+        struct_refs = []
+        enum_refs = []
+
+        content.scan(API_LINK_PATTERN) do |_text, _category, name|
+          if name.start_with?("cf_")
+            func_refs << name
+          elsif name.start_with?("CF_") || name.match?(/^[A-Z]/)
+            # Uppercase names are likely structs or enums
+            # Will be refined when cross-referenced with index
+            struct_refs << name
+          end
+        end
+
+        [func_refs, struct_refs, enum_refs]
+      end
+
+      def extract_topic_references(content)
+        refs = []
+        content.scan(TOPIC_LINK_PATTERN) do |_text, slug|
+          refs << slug
+        end
+        refs
+      end
+
+      def derive_category(slug)
+        CATEGORY_MAP[slug] || slug
+      end
+
+      CATEGORY_MAP = {
+        "audio" => "audio",
+        "camera" => "draw",
+        "collision" => "collision",
+        "coroutines" => "coroutine",
+        "drawing" => "draw",
+        "input" => "input",
+        "networking" => "net",
+        "strings" => "string",
+        "random_numbers" => "math",
+        "application_window" => "app",
+        "game_loop_and_time" => "time",
+        "file_io" => "file",
+        "virtual_file_system" => "file",
+        "multithreading" => "thread",
+        "atomics" => "atomic",
+        "data_structures" => "array",
+        "allocator" => "alloc",
+        "emscripten" => "app",
+        "ios" => "app",
+        "web" => "https",
+        "dear_imgui" => "imgui",
+        "low_level_graphics" => "graphics",
+        "renderer" => "graphics",
+        "shader_compilation" => "graphics"
+      }.freeze
+    end
+  end
+end

data/lib/cf/mcp/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module CF
+  module MCP
+    VERSION = "0.9.2"
+  end
+end

data/lib/cf/mcp.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "mcp/version"
+require_relative "mcp/models/doc_item"
+require_relative "mcp/models/function_doc"
+require_relative "mcp/models/struct_doc"
+require_relative "mcp/models/enum_doc"
+require_relative "mcp/parser"
+require_relative "mcp/index"
+require_relative "mcp/server"
+require_relative "mcp/downloader"
+require_relative "mcp/cli"
+
+module CF
+  module MCP
+    class Error < StandardError; end
+
+    def self.root
+      @root ||= Pathname.new(File.expand_path("../..", __dir__))
+    end
+  end
+end

data/sig/cf/mcp.rbs

@@ -0,0 +1,84 @@
+module CF
+  module MCP
+    VERSION: String
+
+    class Error < StandardError
+    end
+
+    class Parser
+      def parse_file: (String path) -> Array[Models::DocItem]
+      def parse_directory: (String path) -> Array[Models::DocItem]
+    end
+
+    class Index
+      attr_reader items: Hash[String, Models::DocItem]
+      attr_reader by_type: Hash[Symbol, Array[Models::DocItem]]
+      attr_reader by_category: Hash[String, Array[Models::DocItem]]
+
+      def add: (Models::DocItem item) -> void
+      def find: (String name) -> Models::DocItem?
+      def search: (String query, ?type: Symbol?, ?category: String?, ?limit: Integer) -> Array[Models::DocItem]
+      def functions: () -> Array[Models::DocItem]
+      def structs: () -> Array[Models::DocItem]
+      def enums: () -> Array[Models::DocItem]
+      def categories: () -> Array[String]
+      def items_in_category: (String category) -> Array[Models::DocItem]
+      def size: () -> Integer
+      def stats: () -> Hash[Symbol, Integer]
+    end
+
+    class CLI
+      def initialize: (Array[String] args) -> void
+      def run: () -> void
+    end
+
+    class Server
+      attr_reader server: untyped
+      attr_reader index: Index
+
+      def initialize: (Index index) -> void
+      def run_stdio: () -> void
+      def run_http: (?port: Integer) -> void
+      def run_sse: (?port: Integer) -> void
+    end
+
+    module Models
+      class DocItem
+        attr_accessor name: String?
+        attr_accessor type: Symbol?
+        attr_accessor category: String?
+        attr_accessor brief: String?
+        attr_accessor remarks: String?
+        attr_accessor example: String?
+        attr_accessor example_brief: String?
+        attr_accessor related: Array[String]
+        attr_accessor source_file: String?
+
+        def matches?: (String query) -> bool
+        def to_h: () -> Hash[Symbol, untyped]
+        def to_summary: () -> String
+        def to_text: (?detailed: bool) -> String
+      end
+
+      class FunctionDoc < DocItem
+        attr_accessor signature: String?
+        attr_accessor parameters: Array[Parameter]
+        attr_accessor return_value: String?
+
+        Parameter: untyped
+      end
+
+      class StructDoc < DocItem
+        attr_accessor members: Array[Member]
+
+        Member: untyped
+      end
+
+      class EnumDoc < DocItem
+        attr_accessor entries: Array[Entry]
+
+        Entry: untyped
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: cf-mcp
+version: !ruby/object:Gem::Version
+  version: 0.9.2
+platform: ruby
+authors:
+- Piotr Usewicz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+description: An MCP server that indexes Cute Framework header files and provides search
+  functionality for structs, functions, enums, and other elements.
+email:
+- piotr@layer22.com
+executables:
+- cf-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- Manifest.txt
+- README.md
+- Rakefile
+- config.ru
+- exe/cf-mcp
+- lib/cf/mcp.rb
+- lib/cf/mcp/cli.rb
+- lib/cf/mcp/downloader.rb
+- lib/cf/mcp/index.rb
+- lib/cf/mcp/models/doc_item.rb
+- lib/cf/mcp/models/enum_doc.rb
+- lib/cf/mcp/models/function_doc.rb
+- lib/cf/mcp/models/struct_doc.rb
+- lib/cf/mcp/models/topic_doc.rb
+- lib/cf/mcp/parser.rb
+- lib/cf/mcp/server.rb
+- lib/cf/mcp/templates/index.erb
+- lib/cf/mcp/templates/script.js
+- lib/cf/mcp/templates/style.css
+- lib/cf/mcp/tools/find_related.rb
+- lib/cf/mcp/tools/get_details.rb
+- lib/cf/mcp/tools/get_topic.rb
+- lib/cf/mcp/tools/list_category.rb
+- 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/search_enums.rb
+- lib/cf/mcp/tools/search_functions.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
+- sig/cf/mcp.rbs
+homepage: https://github.com/pusewicz/cf-mcp
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/pusewicz/cf-mcp
+  source_code_uri: https://github.com/pusewicz/cf-mcp
+  changelog_uri: https://github.com/pusewicz/cf-mcp/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: MCP server providing documentation tools for Cute Framework
+test_files: []