cf-mcp 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6ac6ddc9bfd8c2ba7af914a9abde416092e436ed650ebf153987c2ed6ed5369
-  data.tar.gz: 3f573e333e680a2975bc858179911ae45a4b2382b5ceaeed9ab2432dfec070c9
+  metadata.gz: 5174a31e0d47a40d1096f72d31faba152e8bb0b152f18e50b531b08914fc91ce
+  data.tar.gz: aac343fc66cb7e6cbf6c970bcda8783928323ff46884578fbf5ad146261bed11
 SHA512:
-  metadata.gz: 9c14eb9de223630781010533916abc12999b7186e06dd476d3737a7e66813827806cd5e6b1f1d5571960ea0e3d05bf6025a097ee6c298eb48d1cb90e4fba91f4
-  data.tar.gz: 8427a7e2dd1ccb6cdd785292273199e15afc5644a81eff5ee2904efb464da055449c72b404bb6c6cff56d2f166cc6913011cca82c703ec9aaf1187b20e7b8da5
+  metadata.gz: 46af43cb876c7cd63d118e45e83c857ebfba53b010b2f7e5f1ad66965cb93e72eeb112f7ea336af967d7a79e25b8db93b33e8d85fedb95fd91868f48671efc7e
+  data.tar.gz: 94c9a33174d1be1b4b236e4603c3eb8f87c5e6905f79c861e455eec6ed4cad36bf16360bc979f363fb4429794cfd2805eb02873901f606fb510730724eaf8e73

data/README.md

@@ -35,6 +35,34 @@ cf-mcp stdio --root /path/to/cute_framework_project  # STDIO mode
 cf-mcp http --root /path/to/cute_framework_project   # HTTP mode with web UI
 ```
 
+## Inspecting with MCP Inspector
+
+You can use the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to debug and test the server.
+
+### STDIO Mode
+
+Run the inspector with the cf-mcp command directly:
+
+```bash
+npx @modelcontextprotocol/inspector cf-mcp stdio --root /path/to/cute_framework
+```
+
+This starts the inspector web UI at `http://localhost:6274` connected to your MCP server.
+
+### HTTP Mode
+
+First, start the server in HTTP mode:
+
+```bash
+cf-mcp http --root /path/to/cute_framework --port 9292
+```
+
+Then launch the inspector and connect using Streamable HTTP transport to:
+
+```
+http://localhost:9292/http
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

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 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/]
 
   files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
     ls.readlines("\x0", chomp: true)

data/lib/cf/mcp/downloader.rb

@@ -102,7 +102,7 @@ module CF
               FileUtils.mkdir_p(target_path)
             else
               FileUtils.mkdir_p(File.dirname(target_path))
-              entry.extract(target_path)
+              entry.extract(relative_path, destination_directory: base_path)
             end
           end
         end

data/lib/cf/mcp/server.rb

@@ -61,7 +61,7 @@ module CF
 
       def initialize(index)
         @index = index
-        configuration = ::MCP::Configuration.new(protocol_version: "2024-11-05")
+        configuration = ::MCP::Configuration.new(protocol_version: "2025-06-18")
         @server = ::MCP::Server.new(
           name: "cf-mcp",
           configuration:,

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

@@ -9,7 +9,10 @@ module CF
       class FindRelated < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: Find Related"
+
         tool_name "cf_find_related"
+        title TITLE
         description "Find all items related to a given Cute Framework item (bidirectional relationship search)"
 
         input_schema(
@@ -20,6 +23,14 @@ module CF
           required: ["name"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(name:, server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -9,7 +9,10 @@ module CF
       class GetDetails < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: Get Details"
+
         tool_name "cf_get_details"
+        title TITLE
         description "Get detailed documentation for a specific Cute Framework item by exact name"
 
         input_schema(
@@ -20,6 +23,14 @@ module CF
           required: ["name"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         NAMING_TIP = "**Tip:** Cute Framework uses `cf_` prefix for functions and `CF_` prefix for types (structs/enums)."
 
         def self.call(name:, server_context: {})

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

@@ -9,7 +9,10 @@ module CF
       class GetTopic < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: Get Topic"
+
         tool_name "cf_get_topic"
+        title TITLE
         description "Get the full content of a Cute Framework topic guide document"
 
         input_schema(
@@ -20,6 +23,14 @@ module CF
           required: ["name"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(name:, server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -9,7 +9,10 @@ module CF
       class ListCategory < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: List Category"
+
         tool_name "cf_list_category"
+        title TITLE
         description "List all items in a specific category, or list all available categories"
 
         input_schema(
@@ -20,6 +23,14 @@ module CF
           }
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(category: nil, type: nil, server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -9,7 +9,10 @@ module CF
       class ListTopics < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: List Topics"
+
         tool_name "cf_list_topics"
+        title TITLE
         description "List all Cute Framework topic guides, optionally filtered by category or in recommended reading order"
 
         input_schema(
@@ -20,6 +23,14 @@ module CF
           }
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(category: nil, ordered: false, server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -9,7 +9,10 @@ module CF
       class MemberSearch < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: Member Search"
+
         tool_name "cf_member_search"
+        title TITLE
         description "Search Cute Framework structs by member name or type"
 
         input_schema(
@@ -21,6 +24,14 @@ module CF
           required: ["query"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(query:, limit: 20, server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -9,7 +9,10 @@ module CF
       class ParameterSearch < ::MCP::Tool
         extend ResponseHelpers
 
+        TITLE = "CF: Parameter Search"
+
         tool_name "cf_parameter_search"
+        title TITLE
         description "Find Cute Framework functions by parameter or return type"
 
         input_schema(
@@ -25,6 +28,14 @@ module CF
           required: ["type"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         def self.call(type:, direction: "both", server_context: {})
           index = server_context[:index]
           return error_response("Index not available") unless index

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

@@ -11,7 +11,10 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
+        TITLE = "CF: Search Enums"
+
         tool_name "cf_search_enums"
+        title TITLE
         description "Search Cute Framework enums"
 
         input_schema(
@@ -24,6 +27,14 @@ module CF
           required: ["query"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         DETAILS_TIP = "**Tip:** Use `cf_get_details` with an exact name to get full documentation including values and examples."
 
         def self.call(query:, category: nil, limit: 20, server_context: {})

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

@@ -11,7 +11,10 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
+        TITLE = "CF: Search Functions"
+
         tool_name "cf_search_functions"
+        title TITLE
         description "Search Cute Framework functions"
 
         input_schema(
@@ -24,6 +27,14 @@ module CF
           required: ["query"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         DETAILS_TIP = "**Tip:** Use `cf_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: {})

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

@@ -11,7 +11,10 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
+        TITLE = "CF: Search Structs"
+
         tool_name "cf_search_structs"
+        title TITLE
         description "Search Cute Framework structs"
 
         input_schema(
@@ -24,6 +27,14 @@ module CF
           required: ["query"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          open_world_hint: false
+        )
+
         DETAILS_TIP = "**Tip:** Use `cf_get_details` with an exact name to get full documentation including members and examples."
 
         def self.call(query:, category: nil, limit: 20, server_context: {})

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

@@ -11,7 +11,10 @@ module CF
         extend ResponseHelpers
         extend SearchResultFormatter
 
+        TITLE = "CF: Search"
+
         tool_name "cf_search"
+        title TITLE
         description "Search Cute Framework documentation across all types (functions, structs, enums, topics)"
 
         input_schema(
@@ -25,6 +28,14 @@ module CF
           required: ["query"]
         )
 
+        annotations(
+          title: TITLE,
+          read_only_hint: true,
+          destructive_hint: false,
+          idempotent_hint: true,
+          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."
 
         def self.call(query:, type: nil, category: nil, limit: 20, server_context: {})

data/lib/cf/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module CF
   module MCP
-    VERSION = "0.13.1"
+    VERSION = "0.14.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cf-mcp
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - Piotr Usewicz
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.1'
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: '3.2'
 description: An MCP server that indexes Cute Framework header files and provides search
   functionality for structs, functions, enums, and other elements.
 email: