Skip to content

Commit 1b90a8d

Browse files
committed
feat: docs: add @latest tag recommendation for npx commands
1 parent 54a93db commit 1b90a8d

File tree

2 files changed

+19
-7
lines changed

2 files changed

+19
-7
lines changed

README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,14 +42,16 @@ Create a `.cursor/mcp.json` file in your project directory. This option is recom
4242
"mcpServers": {
4343
"@reapi/mcp-openapi": {
4444
"command": "npx",
45-
"args": ["-y", "@reapi/mcp-openapi", "--dir", "./specs"],
45+
"args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "./specs"],
4646
"env": {}
4747
}
4848
}
4949
}
5050
```
5151

5252
> **Tip**: Using a relative path like `./specs` makes the configuration portable and easier to share across team members.
53+
>
54+
> **Note**: We recommend using `@latest` tag as we frequently update the server with new features and improvements.
5355
5456
### Option 2: Global Configuration
5557
Create or edit `~/.cursor/mcp.json` in your home directory to make the server available across all projects:
@@ -59,13 +61,15 @@ Create or edit `~/.cursor/mcp.json` in your home directory to make the server av
5961
"mcpServers": {
6062
"@reapi/mcp-openapi": {
6163
"command": "npx",
62-
"args": ["-y", "@reapi/mcp-openapi", "--dir", "/path/to/your/specs"],
64+
"args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "/path/to/your/specs"],
6365
"env": {}
6466
}
6567
}
6668
}
6769
```
6870

71+
> **Note**: Use `@latest` tag to ensure you always get the most recent version with latest features and improvements.
72+
6973
### Enable in Cursor Settings
7074

7175
After adding the configuration:

llms-install.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,16 +25,24 @@ If the file already exists, merge this configuration with existing entries:
2525
```json
2626
{
2727
"mcpServers": {
28+
"existing-server": {
29+
// ... existing configuration ...
30+
},
2831
"@reapi/mcp-openapi": {
2932
"command": "npx",
30-
"args": ["-y", "@reapi/mcp-openapi", "--dir", "<USER_PROVIDED_PATH>"],
33+
"args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "<USER_PROVIDED_PATH>"],
3134
"env": {}
35+
},
36+
"another-server": {
37+
// ... existing configuration ...
3238
}
33-
// ... keep other existing configurations ...
34-
}
39+
},
40+
"other": {}
3541
}
3642
```
3743

44+
> **Note**: We use `@latest` tag to ensure you always get the most recent version with latest features and improvements.
45+
3846
Example of merging with existing configuration:
3947

4048
```json
@@ -45,7 +53,7 @@ Example of merging with existing configuration:
4553
},
4654
"@reapi/mcp-openapi": {
4755
"command": "npx",
48-
"args": ["-y", "@reapi/mcp-openapi", "--dir", "<USER_PROVIDED_PATH>"],
56+
"args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "<USER_PROVIDED_PATH>"],
4957
"env": {}
5058
},
5159
"another-server": {
@@ -76,4 +84,4 @@ The documentation includes:
7684
- Configuration options
7785
- Best practices for organizing multiple APIs
7886
- Tools and features reference"
79-
```
87+
```

0 commit comments

Comments
 (0)