@cocaxcode/api-testing-mcp 0.4.1 → 0.5.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.
- package/README.md +74 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
<p align="center">
|
|
19
19
|
<a href="#installation">Installation</a> •
|
|
20
20
|
<a href="#just-talk-to-it">Just Talk to It</a> •
|
|
21
|
+
<a href="#works-with-any-api">Any API</a> •
|
|
21
22
|
<a href="#features">Features</a> •
|
|
22
23
|
<a href="#tool-reference">Tool Reference</a> •
|
|
23
24
|
<a href="#storage">Storage</a> •
|
|
@@ -61,6 +62,79 @@ This tool is designed to be used through natural language. You don't need to mem
|
|
|
61
62
|
|
|
62
63
|
---
|
|
63
64
|
|
|
65
|
+
## Works with Any API
|
|
66
|
+
|
|
67
|
+
This isn't limited to your own backend. You can test **any API** — public, third-party, or internal — and manage them all simultaneously through environments.
|
|
68
|
+
|
|
69
|
+
### Managing multiple APIs
|
|
70
|
+
|
|
71
|
+
Set up one environment per API and switch between them instantly:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
"Create an environment called github with BASE_URL https://api.github.com"
|
|
75
|
+
"Create an environment called cloudflare with BASE_URL https://api.cloudflare.com/client/v4"
|
|
76
|
+
"Create an environment called dokploy with BASE_URL https://my-server:3000/api"
|
|
77
|
+
"Create an environment called my-backend with BASE_URL http://localhost:3000"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Add authentication variables to each one:
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
"Set GITHUB_TOKEN in the github environment"
|
|
84
|
+
"Set API_KEY in cloudflare"
|
|
85
|
+
"Set TOKEN in dokploy"
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Then just switch context and start working:
|
|
89
|
+
|
|
90
|
+
```
|
|
91
|
+
"Switch to github"
|
|
92
|
+
"Get my repos" → GET /user/repos with Bearer token
|
|
93
|
+
|
|
94
|
+
"Switch to cloudflare"
|
|
95
|
+
"List all DNS zones" → GET /zones with API key auth
|
|
96
|
+
|
|
97
|
+
"Switch to dokploy"
|
|
98
|
+
"Show me all running projects" → GET /project with token
|
|
99
|
+
|
|
100
|
+
"Switch to my-backend"
|
|
101
|
+
"Create a user with random data" → POST /users with mock body from spec
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Real-world example: testing a third-party API
|
|
105
|
+
|
|
106
|
+
```
|
|
107
|
+
You: "Set up Cloudflare with my API key"
|
|
108
|
+
You: "List my DNS zones"
|
|
109
|
+
You: "Show me all DNS records for cocaxcode.dev"
|
|
110
|
+
You: "Verify that the A record for api.cocaxcode.dev exists"
|
|
111
|
+
You: "How fast is the zones endpoint under load?"
|
|
112
|
+
You: "Save this request as cf-list-zones with tag cloudflare"
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
Every request, collection, and spec is isolated per environment. Your Cloudflare tests don't mix with your local backend tests.
|
|
116
|
+
|
|
117
|
+
### What the storage looks like
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
.api-testing/
|
|
121
|
+
├── active-env # Currently active: "cloudflare"
|
|
122
|
+
├── environments/
|
|
123
|
+
│ ├── github.json # { BASE_URL, GITHUB_TOKEN }
|
|
124
|
+
│ ├── cloudflare.json # { BASE_URL, API_KEY }
|
|
125
|
+
│ ├── dokploy.json # { BASE_URL, TOKEN }
|
|
126
|
+
│ └── my-backend.json # { BASE_URL, TOKEN }
|
|
127
|
+
├── specs/
|
|
128
|
+
│ ├── dokploy.json # Imported OpenAPI spec
|
|
129
|
+
│ └── my-backend.json # Imported OpenAPI spec
|
|
130
|
+
└── collections/
|
|
131
|
+
├── cf-list-zones.json # Saved requests per API
|
|
132
|
+
├── gh-my-repos.json
|
|
133
|
+
└── dok-list-projects.json
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
64
138
|
## Installation
|
|
65
139
|
|
|
66
140
|
### Claude Code
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cocaxcode/api-testing-mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "MCP server
|
|
3
|
+
"version": "0.5.0",
|
|
4
|
+
"description": "MCP server for API testing. 20 tools: HTTP requests, assertions, flows, OpenAPI import, mock data, load testing. Zero cloud dependencies.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"api-testing-mcp": "dist/index.js"
|