cf-mcp 0.14.3 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f93636ad4c9468a80315d49368037c7e653e44d3227e66ddf3880c3bd658a04e
-  data.tar.gz: 995a1c37a451572ca558c61f3c7036c1e485120d7d7f97ff7ba2301cf600f22b
+  metadata.gz: 195399f6d4f2c7d1ec73c2d09509cfb2ff5277beba85fa6fc02c1e82a014d8d7
+  data.tar.gz: 136d0ccffbfad51290e9e4ef3d0af0ad116176f35909f87c53e4032db34adbe8
 SHA512:
-  metadata.gz: be375c2b81d73ea8b35cb1271ba0179484ea93d37664e1794a5757099c698d82281c6a193554bc81411e4e21b4218a35cbbf69d33f567c58f9d10bec73c4389c
-  data.tar.gz: 05c74b135b578e6778913f80a5c7073f574ea59a02a4003b335686bd6e0aec8d8cc0402f6fc1dcce8c42c5e6f681397313c6902367eaf6315717e0e269b6767b
+  metadata.gz: 488b3588f45c40fc22a1ef6472a801b7eefff38c69c2bb2b9dd4d74f006ae7af878b5893bf61606e82f6a558ce5a5433fabc8ccfde848a8af5d8c1f21391170b
+  data.tar.gz: fab33790cd94cb57d26f4722f0c7c88ea9e54436e9e60dac805a1b3260160e0740fc388157700195eeb8cfcda77600e4345b15133ee87ce04ce668424195fdce

data/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.15.1] - 2026-01-26
+
+### Added
+
+- PNG icon (262x218) as additional server icon option
+
+## [0.15.0] - 2026-01-26
+
+### Changed
+
+- **BREAKING:** Removed `cf_` prefix from all tool names (e.g., `cf_search` is now `search`)
+- **BREAKING:** Removed `CF: ` prefix from all tool titles (e.g., `CF: Search` is now `Search`)
+- Renamed `CLAUDE.md` to `AGENTS.md` with `CLAUDE.md` referencing it
+
+### Added
+
+- MCP Inspector usage instructions in README
+
 ## [0.14.3] - 2026-01-26
 
 ### Changed
@@ -187,6 +205,8 @@ 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.15.1]: https://github.com/pusewicz/cf-mcp/compare/v0.15.0...v0.15.1
+[0.15.0]: https://github.com/pusewicz/cf-mcp/compare/v0.14.3...v0.15.0
 [0.14.3]: https://github.com/pusewicz/cf-mcp/compare/v0.14.2...v0.14.3
 [0.14.2]: https://github.com/pusewicz/cf-mcp/compare/v0.14.1...v0.14.2
 [0.14.1]: https://github.com/pusewicz/cf-mcp/compare/v0.14.0...v0.14.1

data/Manifest.txt

@@ -16,6 +16,7 @@ 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/public/logo.png
 lib/cf/mcp/public/logo.svg
 lib/cf/mcp/server.rb
 lib/cf/mcp/templates/index.erb

data/lib/cf/mcp/server.rb

@@ -61,7 +61,6 @@ module CF
 
       PROTOCOL_VERSION = "2025-06-18"
       WEBSITE_URL = ENV.fetch("FLY_APP_NAME", nil) ? "https://#{ENV["FLY_APP_NAME"]}.fly.dev" : "https://cf-mcp.fly.dev"
-      LOGO_PATH = "/logo.svg"
       PUBLIC_DIR = File.join(__dir__, "public")
 
       def initialize(index)
@@ -74,7 +73,8 @@ module CF
           version: CF::MCP::VERSION,
           website_url: WEBSITE_URL,
           icons: [
-            ::MCP::Icon.new(src: "#{WEBSITE_URL}#{LOGO_PATH}", mime_type: "image/svg+xml", sizes: ["any"])
+            ::MCP::Icon.new(src: "#{WEBSITE_URL}/logo.svg", mime_type: "image/svg+xml", sizes: ["any"]),
+            ::MCP::Icon.new(src: "#{WEBSITE_URL}/logo.png", mime_type: "image/png", sizes: ["262x218"])
           ],
           tools: TOOLS,
           resources: build_topic_resources(index)
@@ -120,11 +120,13 @@ module CF
             [404, {"content-type" => "application/json"}, ['{"error":"Not found"}']]
           when %r{^/http(/|$)}
             http_transport.handle_request(request)
-          when "/logo.svg"
+          when "/logo.svg", "/logo.png"
             # Serve logo as static asset
-            logo_path = File.join(public_dir, "logo.svg")
+            filename = path.delete_prefix("/")
+            logo_path = File.join(public_dir, filename)
             if File.exist?(logo_path)
-              [200, {"content-type" => "image/svg+xml", "cache-control" => "public, max-age=86400"}, [File.read(logo_path)]]
+              content_type = filename.end_with?(".svg") ? "image/svg+xml" : "image/png"
+              [200, {"content-type" => content_type, "cache-control" => "public, max-age=86400"}, [File.read(logo_path, mode: "rb")]]
             else
               [404, {"content-type" => "text/plain"}, ["Not found"]]
             end

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

@@ -9,9 +9,9 @@ module CF
       class FindRelated < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: Find Related"
+        TITLE = "Find Related"
 
-        tool_name "cf_find_related"
+        tool_name "find_related"
         title TITLE
         description "Find all items related to a given Cute Framework item (bidirectional relationship search)"
 

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

@@ -9,9 +9,9 @@ module CF
       class GetDetails < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: Get Details"
+        TITLE = "Get Details"
 
-        tool_name "cf_get_details"
+        tool_name "get_details"
         title TITLE
         description "Get detailed documentation for a specific Cute Framework item by exact name"
 
@@ -57,7 +57,7 @@ module CF
               if related_topics.any?
                 output += "\n\n## Related Topics\n"
                 output += related_topics.map { |t| "- **#{t.name}** — #{t.brief}" }.join("\n")
-                output += "\n\n**Tip:** Use `cf_get_topic` to read the full topic content."
+                output += "\n\n**Tip:** Use `get_topic` to read the full topic content."
               end
             end
 

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

@@ -9,9 +9,9 @@ module CF
       class GetTopic < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: Get Topic"
+        TITLE = "Get Topic"
 
-        tool_name "cf_get_topic"
+        tool_name "get_topic"
         title TITLE
         description "Get the full content of a Cute Framework topic guide document"
 
@@ -44,7 +44,7 @@ module CF
             }
 
             if suggestions.empty?
-              text_response("Topic not found: '#{name}'\n\nUse `cf_list_topics` to see available topics.")
+              text_response("Topic not found: '#{name}'\n\nUse `list_topics` to see available topics.")
             else
               formatted = suggestions.map { |t| "- **#{t.name}** — #{t.brief}" }.join("\n")
               text_response("Topic not found: '#{name}'\n\n**Similar topics:**\n#{formatted}")

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

@@ -9,9 +9,9 @@ module CF
       class ListCategory < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: List Category"
+        TITLE = "List Category"
 
-        tool_name "cf_list_category"
+        tool_name "list_category"
         title TITLE
         description "List all items in a specific category, or list all available categories"
 
@@ -49,7 +49,7 @@ module CF
                   .join(", ")
                 "- **#{cat}** — #{items.size} items (#{type_breakdown})"
               end.join("\n")
-              text_response("Available categories:\n\n#{formatted}\n\n**Tip:** Use `cf_list_category` with a category name to see all items in that category.")
+              text_response("Available categories:\n\n#{formatted}\n\n**Tip:** Use `list_category` with a category name to see all items in that category.")
             end
           else
             # List items in the specified category
@@ -73,7 +73,7 @@ module CF
                 ""
               end
 
-              text_response("Items in '#{category}':\n\n#{formatted}#{topic_suggestion}\n\n**Tip:** Use `cf_get_details` with an exact name to get full documentation.")
+              text_response("Items in '#{category}':\n\n#{formatted}#{topic_suggestion}\n\n**Tip:** Use `get_details` with an exact name to get full documentation.")
             end
           end
         end

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

@@ -9,9 +9,9 @@ module CF
       class ListTopics < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: List Topics"
+        TITLE = "List Topics"
 
-        tool_name "cf_list_topics"
+        tool_name "list_topics"
         title TITLE
         description "List all Cute Framework topic guides, optionally filtered by category or in recommended reading order"
 
@@ -58,12 +58,12 @@ module CF
           end
 
           lines << ""
-          lines << "**Tip:** Use `cf_get_topic` with a topic name to read the full content."
+          lines << "**Tip:** Use `get_topic` with a topic name to read the full content."
 
           text_response(lines.join("\n"))
         end
 
-        CATEGORY_TIP = "Use `cf_list_topics` without a category to see all available topics."
+        CATEGORY_TIP = "Use `list_topics` without a category to see all available topics."
       end
     end
   end

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

@@ -9,9 +9,9 @@ module CF
       class MemberSearch < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: Member Search"
+        TITLE = "Member Search"
 
-        tool_name "cf_member_search"
+        tool_name "member_search"
         title TITLE
         description "Search Cute Framework structs by member name or type"
 
@@ -72,7 +72,7 @@ module CF
             lines << ""
           end
 
-          lines << "**Tip:** Use `cf_get_details` with a struct name for full documentation."
+          lines << "**Tip:** Use `get_details` with a struct name for full documentation."
 
           text_response(lines.join("\n"))
         end

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

@@ -9,9 +9,9 @@ module CF
       class ParameterSearch < ::MCP::Tool
         extend ResponseHelpers
 
-        TITLE = "CF: Parameter Search"
+        TITLE = "Parameter Search"
 
-        tool_name "cf_parameter_search"
+        tool_name "parameter_search"
         title TITLE
         description "Find Cute Framework functions by parameter or return type"
 
@@ -98,7 +98,7 @@ module CF
             lines << ""
           end
 
-          lines << "**Tip:** Use `cf_get_details` with a function name for full documentation."
+          lines << "**Tip:** Use `get_details` with a function name for full documentation."
 
           text_response(lines.join("\n"))
         end

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

@@ -11,9 +11,9 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
-        TITLE = "CF: Search Enums"
+        TITLE = "Search Enums"
 
-        tool_name "cf_search_enums"
+        tool_name "search_enums"
         title TITLE
         description "Search Cute Framework enums"
 
@@ -35,7 +35,7 @@ module CF
           open_world_hint: false
         )
 
-        DETAILS_TIP = "**Tip:** Use `cf_get_details` with an exact name to get full documentation including values and examples."
+        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]

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

@@ -11,9 +11,9 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
-        TITLE = "CF: Search Functions"
+        TITLE = "Search Functions"
 
-        tool_name "cf_search_functions"
+        tool_name "search_functions"
         title TITLE
         description "Search Cute Framework functions"
 
@@ -35,7 +35,7 @@ module CF
           open_world_hint: false
         )
 
-        DETAILS_TIP = "**Tip:** Use `cf_get_details` with an exact name to get full documentation including signature, parameters, and examples."
+        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]

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

@@ -11,9 +11,9 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
-        TITLE = "CF: Search Structs"
+        TITLE = "Search Structs"
 
-        tool_name "cf_search_structs"
+        tool_name "search_structs"
         title TITLE
         description "Search Cute Framework structs"
 
@@ -35,7 +35,7 @@ module CF
           open_world_hint: false
         )
 
-        DETAILS_TIP = "**Tip:** Use `cf_get_details` with an exact name to get full documentation including members and examples."
+        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]

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

@@ -11,9 +11,9 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
-        TITLE = "CF: Search"
+        TITLE = "Search"
 
-        tool_name "cf_search"
+        tool_name "search"
         title TITLE
         description "Search Cute Framework documentation across all types (functions, structs, enums, topics)"
 
@@ -36,7 +36,7 @@ module CF
           open_world_hint: false
         )
 
-        DETAILS_TIP = "**Tip:** Use `cf_get_details` for API items or `cf_get_topic` for topic guides to get full documentation."
+        DETAILS_TIP = "**Tip:** Use `get_details` for API items or `get_topic` for topic guides to get full documentation."
 
         def self.call(query:, type: nil, category: nil, limit: 20, server_context: {})
           index = server_context[:index]

data/lib/cf/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module CF
   module MCP
-    VERSION = "0.14.3"
+    VERSION = "0.15.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cf-mcp
 version: !ruby/object:Gem::Version
-  version: 0.14.3
+  version: 0.15.1
 platform: ruby
 authors:
 - Piotr Usewicz
@@ -106,6 +106,7 @@ files:
 - lib/cf/mcp/models/struct_doc.rb
 - lib/cf/mcp/models/topic_doc.rb
 - lib/cf/mcp/parser.rb
+- lib/cf/mcp/public/logo.png
 - lib/cf/mcp/public/logo.svg
 - lib/cf/mcp/server.rb
 - lib/cf/mcp/templates/index.erb