@dilina0914/openapi-mcp 7.0.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +67 -11
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,18 +1,74 @@
1
1
  # OpenAPI MCP Server
2
2
 
3
- A Model Context Protocol (MCP) server for parsing OpenAPI specifications and extracting Cloud ERP service metadata. Load specs, explore endpoints, extract schemas, and search operations through MCP tools.
3
+ A Model Context Protocol (MCP) server for parsing OpenAPI 3.0 specifications and extracting API metadata. Provides 7 tools for spec management, endpoint discovery, and schema extraction - complementing code-first analysis when OpenAPI specifications are available.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@dilina0914/openapi-mcp.svg)](https://www.npmjs.com/package/@dilina0914/openapi-mcp)
6
6
  [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)
7
7
 
8
- ## Features
8
+ ## What's New in 9.0.0
9
9
 
10
- - **OpenAPI Parsing**: Load and parse OpenAPI 3.0 specifications from files or URLs
11
- - **7 Powerful Tools**: Complete API discovery, schema extraction, and operation search
12
- - **Endpoint Discovery**: List and filter API endpoints by tags, paths, or methods
13
- - **Schema Extraction**: Extract entity schemas with data types, required fields, and examples
14
- - **Operation Search**: Search operations by query, tag, or entity name
15
- - **Multi-Spec Support**: Load and manage multiple specs simultaneously
10
+ ### Alignment & Documentation
11
+
12
+ **✅ Complete System Alignment**
13
+ - Fully aligned with `sar-test-mcp` v9.0.0 and `http-capture-mcp` v9.0.0
14
+ - Consistent with updated workflow in SARDevAgent
15
+ - All three MCPs work seamlessly together in the 13-phase test generation workflow
16
+
17
+ **📚 Documentation Updates**
18
+ - Updated integration examples to reflect current architecture
19
+ - Clarified role in code-first test generation approach
20
+ - Enhanced troubleshooting guide
21
+
22
+ ## What's New in 8.0.0
23
+
24
+ ### Documentation & Setup
25
+
26
+ **📚 Complete Documentation Overhaul**
27
+ - Comprehensive README with accurate feature descriptions
28
+ - Clear integration instructions for all platforms
29
+ - Detailed troubleshooting guide
30
+ - Complete tool reference with examples
31
+
32
+ **🎯 Purpose Clarification**
33
+ - Designed for OpenAPI 3.0 specification parsing
34
+ - Complements code-first approach in `sar-test-mcp`
35
+ - Provides API metadata when OpenAPI specs are available
36
+ - 7 focused tools for spec management, endpoint discovery, and schema extraction
37
+
38
+ ### Features
39
+
40
+ **📖 OpenAPI Parsing**
41
+ - Load specs from local files or URLs
42
+ - Support for JSON and YAML formats
43
+ - Automatic `$ref` resolution
44
+ - Multi-spec management
45
+
46
+ **🔍 Endpoint Discovery**
47
+ - List all API endpoints with filtering
48
+ - Filter by tags, paths, or methods
49
+ - Search operations by query or entity
50
+ - Get complete operation details
51
+
52
+ **📊 Schema Extraction**
53
+ - Extract entity schemas with data types
54
+ - Identify required fields and constraints
55
+ - Include default values and examples
56
+ - Resolve nested references
57
+
58
+ ### Use Cases
59
+
60
+ 1. **API Discovery**: When OpenAPI specs are available for IFS Cloud services
61
+ 2. **Schema Validation**: Verify entity structures and field types
62
+ 3. **Endpoint Mapping**: Map service endpoints to test requirements
63
+ 4. **Documentation**: Extract API documentation for test planning
64
+ 5. **Complementary Analysis**: Use alongside code analysis from `sar-test-mcp`
65
+
66
+ ### Integration
67
+
68
+ Works seamlessly with `sar-test-mcp` and `http-capture-mcp`:
69
+ - `sar-test-mcp` for code-first analysis (primary approach)
70
+ - `openapi-mcp` for API spec metadata (when available)
71
+ - `http-capture-mcp` for browser verification (when needed)
16
72
 
17
73
  ## Prerequisites
18
74
 
@@ -67,7 +123,7 @@ Inside the `.vscode` folder, create a file named `mcp.json` with the following c
67
123
  "command": "npx",
68
124
  "args": [
69
125
  "-y",
70
- "@dilina0914/openapi-mcp@7.0.0"
126
+ "@dilina0914/openapi-mcp@8.0.0"
71
127
  ],
72
128
  "env": {
73
129
  "LOG_LEVEL": "info",
@@ -111,7 +167,7 @@ In the MCP settings, add a new server with the following configuration:
111
167
  "command": "npx",
112
168
  "args": [
113
169
  "-y",
114
- "@dilina0914/openapi-mcp@7.0.0"
170
+ "@dilina0914/openapi-mcp@8.0.0"
115
171
  ],
116
172
  "env": {
117
173
  "LOG_LEVEL": "info"
@@ -137,7 +193,7 @@ Add to your Claude Desktop configuration file:
137
193
  "mcpServers": {
138
194
  "openapi": {
139
195
  "command": "npx",
140
- "args": ["-y", "@dilina0914/openapi-mcp@7.0.0"],
196
+ "args": ["-y", "@dilina0914/openapi-mcp@8.0.0"],
141
197
  "env": {
142
198
  "LOG_LEVEL": "info"
143
199
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dilina0914/openapi-mcp",
3
- "version": "7.0.0",
3
+ "version": "9.0.0",
4
4
  "description": "MCP server for parsing OpenAPI specifications and extracting Cloud ERP service metadata",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",