filter operations by tag

Author: alexcheng1982

README.md

@@ -6,16 +6,16 @@ Convert OpenAPI spec to MCP server, OpenAPI operations as tools
 
 When running the MCP server, an OpenAPI spec is required. It can be either a file path or URL.
 
-The MCP server also provides options to filter operations to be converted as MCP tools.
+The MCP server also provides options to filter operations to be converted as MCP tools. Filter conditions of the same type are combined using `OR`, while filter conditions of different types are combined using 'AND'.
 
 Currently supported filter conditions:
 
-|Condition|CLI option|Example|
-|---|---|---|
-|HTTP method| `--include-http-method` | `--include-http-method=GET` |
-|Path| `--include-path` | `--include-path=/holidays` |
-|Operation Id| `--include-operation-id` | `--include-operation-id=Root` |
-
+| Condition    | CLI option               | Example                       |
+|--------------|--------------------------|-------------------------------|
+| HTTP method  | `--include-http-method`  | `--include-http-method=GET`   |
+| Path         | `--include-path`         | `--include-path=/holidays`    |
+| Operation Id | `--include-operation-id` | `--include-operation-id=Root` |
+| Tag          | `--include-tag`          | `--include-tag=info`          |
 
 You can run the JAR file to see the CLI help.
 
@@ -24,7 +24,8 @@ Usage: openapi-mcp [-hV] [--include-http-method=<includeHttpMethods>[,
                    <includeHttpMethods>...]]...
                    [--include-operation-id=<includeOperationIds>[,
                    <includeOperationIds>...]]... [--include-path=<includePaths>
-                   [,<includePaths>...]]... <openapiSpec>
+                   [,<includePaths>...]]... [--include-tag=<includeTags>[,
+                   <includeTags>...]]... <openapiSpec>
 Run OpenAPI MCP server
       <openapiSpec>   File path or URL of OpenAPI spec
   -h, --help          Show this help message and exit.
@@ -34,10 +35,11 @@ Run OpenAPI MCP server
                       Include operations with id (comma separated)
       --include-path=<includePaths>[,<includePaths>...]
                       Include operations with paths (comma separated)
+      --include-tag=<includeTags>[,<includeTags>...]
+                      Include operations with tags (comma separated)
   -V, --version       Print version information and exit.
 ```
 
-
 ## How to Run
 
 ### Container

src/main/kotlin/com/javaaidev/mcp/openapi/Cli.kt

@@ -35,10 +35,22 @@ class Cli : Callable<Int> {
     )
     private val includePaths: List<String>? = null
 
+    @CommandLine.Option(
+        names = ["--include-tag"],
+        split = ",",
+        description = ["Include operations with tags (comma separated)"]
+    )
+    private val includeTags: List<String>? = null
+
     override fun call(): Int {
         McpServer.start(
             openapiSpec,
-            OpenAPIOperationFilter(includeOperationIds, includeHttpMethods, includePaths)
+            OpenAPIOperationFilter(
+                includeOperationIds,
+                includeHttpMethods,
+                includePaths,
+                includeTags
+            )
         )
         return 0
     }

src/main/kotlin/com/javaaidev/mcp/openapi/McpTool.kt

@@ -29,6 +29,7 @@ data class OpenAPIOperationFilter(
     val operationIds: List<String>? = null,
     val httpMethods: List<String>? = null,
     val paths: List<String>? = null,
+    val tags: List<String>? = null,
 ) {
     fun match(operation: OpenAPIOperation): Boolean {
         val checkers = mutableListOf<Supplier<Boolean>>()
@@ -52,6 +53,12 @@ data class OpenAPIOperationFilter(
                 }
             }
         }
+        tags?.let {
+            checkers.add {
+                !operation.operation.tags.isNullOrEmpty() &&
+                        it.intersect(operation.operation.tags).isNotEmpty()
+            }
+        }
         return checkers.all { it.get() }
     }
 }

src/test/kotlin/com/javaaidev/mcp/openapi/McpToolHelperTest.kt

@@ -49,5 +49,11 @@ class McpToolHelperTest {
             )
         )
         assertEquals(1, tools.size)
+        tools = McpToolHelper.toTools(
+            openAPI, OpenAPIOperationFilter(
+                tags = listOf("holidays")
+            )
+        )
+        assertEquals(2, tools.size)
     }
 }