@apicircle/mcp-server 1.0.5 → 1.0.7
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 +18 -13
- package/dist/bin/mcp-server.cjs +470 -272
- package/dist/bin/mcp-server.cjs.map +1 -1
- package/dist/index.cjs +456 -265
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +458 -261
- package/dist/index.js.map +1 -1
- package/package.json +28 -4
package/README.md
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<strong>Give your AI assistant a real API client.</strong><br />
|
|
9
|
-
A Model Context Protocol server that exposes the API Circle Studio workspace as a <strong>
|
|
9
|
+
A Model Context Protocol server that exposes the API Circle Studio workspace as a <strong>74-tool catalog</strong> — so Claude, ChatGPT, Cursor, Copilot, and every other MCP client can read, author, mock, and run requests for you.
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
<p align="center">
|
|
13
13
|
<a href="https://www.npmjs.com/package/@apicircle/mcp-server"><img src="https://img.shields.io/npm/v/@apicircle/mcp-server?color=cb3837&logo=npm" alt="npm version" /></a>
|
|
14
|
-
<img src="https://img.shields.io/badge/MCP%20tools-
|
|
14
|
+
<img src="https://img.shields.io/badge/MCP%20tools-74-blueviolet" alt="74 MCP tools" />
|
|
15
15
|
<img src="https://img.shields.io/badge/transport-stdio-blue" alt="stdio transport" />
|
|
16
16
|
<img src="https://img.shields.io/badge/multi--workspace-yes-success" alt="Multi-workspace" />
|
|
17
17
|
<img src="https://img.shields.io/badge/node-%E2%89%A5%2020-brightgreen" alt="Node ≥ 20" />
|
|
@@ -61,6 +61,10 @@ apicircle-mcp
|
|
|
61
61
|
# Single-workspace mode — point at a folder with a workspace.synced.json
|
|
62
62
|
# (CI, a git-cloned workspace repo, etc.)
|
|
63
63
|
apicircle-mcp --workspace /path/to/checkout-repo
|
|
64
|
+
|
|
65
|
+
# Diagnostics — handled in-process, no MCP handshake involved
|
|
66
|
+
apicircle-mcp --version # prints the package version
|
|
67
|
+
apicircle-mcp --help # prints the usage block
|
|
64
68
|
```
|
|
65
69
|
|
|
66
70
|
The server speaks JSON-RPC on stdin/stdout (logs to stderr). Plug it into
|
|
@@ -136,22 +140,23 @@ In multi-workspace mode the assistant gets two extra surfaces:
|
|
|
136
140
|
Entity tools (`request.read`, `environment.create`, `mock.start`, etc.) all
|
|
137
141
|
default to the active workspace — multi-workspace scoping is opt-in per call.
|
|
138
142
|
|
|
139
|
-
## The tool catalog (
|
|
143
|
+
## The tool catalog (74 tools)
|
|
140
144
|
|
|
141
145
|
The full list lives at
|
|
142
146
|
[`docs/mcp-tools-reference.md`](https://github.com/apicircle/studio/blob/main/docs/mcp-tools-reference.md).
|
|
143
147
|
Highlights by category:
|
|
144
148
|
|
|
145
|
-
| Category | What the AI can do
|
|
146
|
-
| --------------------------- |
|
|
147
|
-
| **Workspaces** | `workspace.list`, `workspace.read`, `workspace.write` (bulk + scoped by `workspaceId`)
|
|
148
|
-
| **Entity CRUD** | Requests, folders, environments, plans, assertions — full read / write surface
|
|
149
|
-
| **
|
|
150
|
-
| **
|
|
151
|
-
| **
|
|
152
|
-
| **
|
|
153
|
-
| **
|
|
154
|
-
| **
|
|
149
|
+
| Category | What the AI can do |
|
|
150
|
+
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
151
|
+
| **Workspaces** | `workspace.list`, `workspace.read`, `workspace.write` (bulk + scoped by `workspaceId`) |
|
|
152
|
+
| **Entity CRUD** | Requests, folders, environments, plans, assertions — full read / write surface |
|
|
153
|
+
| **Folder exchange** | `folder.export_json`, `folder.import_json` — portable `apicircle.folder/v1` envelope with embedded JSON Schema + GraphQL dependencies; credentials redacted by default |
|
|
154
|
+
| **Imports** | `import.curl`, `import.openapi`, `import.postman`, `import.insomnia`, `import.har` |
|
|
155
|
+
| **Code generation** | `generate.code` for cURL, fetch, axios, Python requests, Go, Rust |
|
|
156
|
+
| **Codebase analysis** | `codebase.extract_collection` — Express, FastAPI, NestJS, Spring |
|
|
157
|
+
| **Prompt-driven authoring** | LLM-shaped JSON entry points for request / folder / environment / assertion / plan / mock creation |
|
|
158
|
+
| **Mock servers** | `mock.create_from_openapi`, `mock.start`, `mock.stop`, `mock.delete`, … |
|
|
159
|
+
| **History** | `history.list_runs`, `history.get_run`, `history.delete_run`, `history.purge_by_age` |
|
|
155
160
|
|
|
156
161
|
## Embed it in your own product
|
|
157
162
|
|