Skip to content

Commit 5fd499b

Browse files
garciasdosgarciasdos
authored
feat: add full and minimal versions of Postman MCP server manifests (#40)
- Introduced `manifest-full.json` for the comprehensive MCP server with 106+ tools. - Introduced `manifest-minimal.json` for the essential MCP server with 37 tools. - Updated README to include details on downloading the new `.dxt` files for both versions. - Enhanced GitHub Actions workflow to package and upload both versions of the extension.
1 parent 2c7acb1 commit 5fd499b

File tree

4 files changed

+113
-16
lines changed

4 files changed

+113
-16
lines changed

‎.github/workflows/dxt-pack.yaml‎

Lines changed: 33 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -21,32 +21,55 @@ jobs:
2121
- name: Install dependencies
2222
run: npm ci
2323

24-
- name: Sync manifest version with package.json
24+
- name: Sync manifest versions with package.json
2525
run: |
2626
pkg_version=$(jq -r .version package.json)
27-
jq --arg v "$pkg_version" '.version = $v' manifest.json > manifest.tmp.json
28-
mv manifest.tmp.json manifest.json
27+
jq --arg v "$pkg_version" '.version = $v' manifest-minimal.json > manifest-minimal.tmp.json
28+
mv manifest-minimal.tmp.json manifest-minimal.json
29+
jq --arg v "$pkg_version" '.version = $v' manifest-full.json > manifest-full.tmp.json
30+
mv manifest-full.tmp.json manifest-full.json
2931
3032
- name: Build project
3133
run: npm run build
3234

33-
- name: Install DXT
35+
- name: Install dependencies for packaging
3436
run: npm ci --omit=dev
3537

3638
- name: Install DXT
3739
run: npm install -g @anthropic-ai/dxt
3840

39-
- name: Package extension
41+
- name: Package extensions
4042
run: |
41-
dxt pack
4243
current_dir=$(basename "$PWD")
43-
echo "DXT_FILENAME=${current_dir}.dxt" >> $GITHUB_ENV
44+
45+
# Package minimal version
46+
cp manifest-minimal.json manifest.json
47+
dxt pack
48+
mv "${current_dir}.dxt" "${current_dir}-minimal.dxt"
49+
50+
# Package full version
51+
cp manifest-full.json manifest.json
52+
dxt pack
53+
mv "${current_dir}.dxt" "${current_dir}-full.dxt"
54+
55+
# Set environment variables
56+
echo "DXT_MINIMAL_FILENAME=${current_dir}-minimal.dxt" >> $GITHUB_ENV
57+
echo "DXT_FULL_FILENAME=${current_dir}-full.dxt" >> $GITHUB_ENV
58+
59+
- name: Upload minimal release asset
60+
uses: svenstaro/upload-release-action@7027b7670c56b9473901daad1fb8a09ab534688e
61+
with:
62+
repo_token: ${{ secrets.GITHUB_TOKEN }}
63+
file: ${{ env.DXT_MINIMAL_FILENAME }}
64+
asset_name: ${{ env.DXT_MINIMAL_FILENAME }}
65+
tag: ${{ github.ref }}
66+
overwrite: true
4467

45-
- name: Upload release asset
68+
- name: Upload full release asset
4669
uses: svenstaro/upload-release-action@7027b7670c56b9473901daad1fb8a09ab534688e
4770
with:
4871
repo_token: ${{ secrets.GITHUB_TOKEN }}
49-
file: ${{ env.DXT_FILENAME }}
50-
asset_name: ${{ env.DXT_FILENAME }}
72+
file: ${{ env.DXT_FULL_FILENAME }}
73+
asset_name: ${{ env.DXT_FULL_FILENAME }}
5174
tag: ${{ github.ref }}
5275
overwrite: true

‎README.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,12 @@ Configure the extension to use the **postman-api-mcp** server, a local STDIO-bas
6060

6161
### Claude integration
6262

63-
To integrate the MCP server with Claude, check the latest [Postman MCP server release](https://github.com/postmanlabs/postman-mcp-server/releases) and get the `.dxt` file. For more information, see Anthropic's [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions) documentation.
63+
To integrate the MCP server with Claude, check the latest [Postman MCP server release](https://github.com/postmanlabs/postman-mcp-server/releases) and download one of the available `.dxt` files:
64+
65+
- **postman-api-mcp-minimal.dxt** - Contains 37 essential tools for basic Postman operations
66+
- **postman-api-mcp-full.dxt** - Contains all 106+ tools for comprehensive Postman functionality
67+
68+
For more information, see Anthropic's [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions) documentation.
6469

6570
## Streamable HTTP
6671

‎manifest-full.json‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
{
2+
"dxt_version": "0.2",
3+
"version": "",
4+
"name": "postman-mcp-server-full",
5+
"display_name": "Postman MCP Server (Full)",
6+
"description": "A comprehensive MCP server with all available Postman API tools (106+ tools).",
7+
"long_description": "This extension enables AI assistants to interact with the Postman API through Model Context Protocol (MCP). This full version provides access to all available Postman API tools including advanced features like collection forks, comments, monitors, PAN operations, and more. All secured with your Postman API key.",
8+
"author": {
9+
"name": "Postman, Inc.",
10+
"email": "[email protected]",
11+
"url": "https://www.postman.com"
12+
},
13+
"repository": {
14+
"type": "git",
15+
"url": "https://github.com/postmanlabs/postman-mcp-server"
16+
},
17+
"homepage": "https://github.com/postmanlabs/postman-mcp-server",
18+
"documentation": "https://learning.postman.com/docs/developer/postman-api/postman-mcp-server/overview",
19+
"support": "https://github.com/postmanlabs/postman-api-mcp/issues",
20+
"icon": "icon.png",
21+
"server": {
22+
"type": "node",
23+
"entry_point": "dist/src/index.js",
24+
"mcp_config": {
25+
"command": "node",
26+
"args": [
27+
"${__dirname}/dist/src/index.js",
28+
"--full"
29+
],
30+
"env": {
31+
"POSTMAN_API_KEY": "${user_config.postman_api_key}"
32+
}
33+
}
34+
},
35+
"keywords": [
36+
"postman",
37+
"api",
38+
"mcp",
39+
"postman-api",
40+
"collections",
41+
"monitors",
42+
"mocks",
43+
"full",
44+
"comprehensive"
45+
],
46+
"license": "Apache-2.0",
47+
"user_config": {
48+
"postman_api_key": {
49+
"type": "string",
50+
"title": "Postman API Key",
51+
"description": "A valid Postman API key used to authenticate requests.",
52+
"sensitive": true,
53+
"required": true
54+
}
55+
},
56+
"compatibility": {
57+
"claude_desktop": ">=0.10.0",
58+
"platforms": [
59+
"darwin",
60+
"win32",
61+
"linux"
62+
],
63+
"runtimes": {
64+
"node": ">=20.0.0"
65+
}
66+
},
67+
"tools_generated": true
68+
}

manifest.json renamed to manifest-minimal.json

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
{
22
"dxt_version": "0.2",
33
"version": "",
4-
"name": "postman-mcp-server",
5-
"display_name": "Postman MCP Server",
6-
"description": "A basic MCP server that operates using the Postman API.",
7-
"long_description": "This extension enables AI assistants to interact with the Postman API through Model Context Protocol (MCP). It provides a rich set of tools for managing your collections, environments, mocks, monitors, and more, all secured with your Postman API key.",
4+
"name": "postman-mcp-server-minimal",
5+
"display_name": "Postman MCP Server (Minimal)",
6+
"description": "A minimal MCP server with essential Postman API tools (37 tools).",
7+
"long_description": "This extension enables AI assistants to interact with the Postman API through Model Context Protocol (MCP). This minimal version includes only the essential tools for basic Postman operations, providing faster performance and simplifying use for common workflows. All secured with your Postman API key.",
88
"author": {
99
"name": "Postman, Inc.",
1010
"email": "[email protected]",
@@ -38,7 +38,8 @@
3838
"postman-api",
3939
"collections",
4040
"monitors",
41-
"mocks"
41+
"mocks",
42+
"minimal"
4243
],
4344
"license": "Apache-2.0",
4445
"user_config": {

0 commit comments

Comments
 (0)