openwire 1.2.0 → 1.2.1
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/CHANGELOG.md +37 -0
- package/README.md +201 -205
- package/ROADMAP.md +15 -0
- package/assets/brand/icon.svg +10 -0
- package/assets/brand/logo-dark.svg +10 -0
- package/assets/brand/logo.svg +10 -0
- package/assets/diagrams/architecture.svg +39 -0
- package/package.json +5 -2
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.2.1 — Documentation and branding
|
|
4
|
+
|
|
5
|
+
- Reorganize the README around quick start, client setup, architecture, configuration, and compatibility.
|
|
6
|
+
- Add the Openwire logo, a dark-theme wordmark, status badges, and an architecture diagram.
|
|
7
|
+
- Organize supplied SVGs under `assets/brand` and package brand assets, diagrams, changelog, and roadmap for npm.
|
|
8
|
+
- Verify required visual assets in the package smoke check.
|
|
9
|
+
|
|
10
|
+
## 1.2.0 — Openwire
|
|
11
|
+
|
|
12
|
+
### Migration
|
|
13
|
+
|
|
14
|
+
- Rename the npm package, primary CLI, default MCP identity, and repository to `openwire`.
|
|
15
|
+
- Keep the `api-mcp-bridge` command as an alias and retain existing environment variables and CLI arguments.
|
|
16
|
+
- Derive the reported MCP version from package metadata.
|
|
17
|
+
|
|
18
|
+
### Fixes
|
|
19
|
+
|
|
20
|
+
- Forward configured headers when downloading protected specifications.
|
|
21
|
+
- Return MCP tool errors for upstream HTTP 4xx/5xx responses.
|
|
22
|
+
- Enforce serialized response character budgets, including JSON punctuation and escaping.
|
|
23
|
+
- Preserve nullable object schemas and avoid mutating input schemas during normalization.
|
|
24
|
+
- Reserve the built-in `health` name when generating operation tools.
|
|
25
|
+
- Resolve local request-body references and select operation/path server overrides.
|
|
26
|
+
- Prefer JSON request media types; reject unsupported encodings when a body is supplied.
|
|
27
|
+
- Refresh affected dependencies within existing major versions to resolve reported advisories.
|
|
28
|
+
|
|
29
|
+
### Maintenance
|
|
30
|
+
|
|
31
|
+
- Remove the empty npm ignore file and duplicate CLI header configuration handling.
|
|
32
|
+
- Add MCP integration tests and installed-package verification to CI.
|
|
33
|
+
- Document actual authentication, response-limit, and OpenAPI compatibility boundaries.
|
|
34
|
+
|
|
35
|
+
## 1.1.0
|
|
36
|
+
|
|
37
|
+
- Resolve CLI entry paths through npm binary symlinks.
|
package/README.md
CHANGED
|
@@ -1,154 +1,86 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
- [Features](#features)
|
|
10
|
-
- [How It Works](#how-it-works)
|
|
11
|
-
- [Requirements](#requirements)
|
|
12
|
-
- [Migrating from api-mcp-bridge](#migrating-from-api-mcp-bridge)
|
|
13
|
-
- [Installation](#installation)
|
|
14
|
-
- [CLI Usage](#cli-usage)
|
|
15
|
-
- [MCP Client Configuration](#mcp-client-configuration)
|
|
16
|
-
- [Configuration & Environment Variables](#configuration--environment-variables)
|
|
17
|
-
- [Authentication](#authentication)
|
|
18
|
-
- [Compatibility and limitations](#compatibility-and-limitations)
|
|
19
|
-
- [Tool Mapping](#tool-mapping)
|
|
20
|
-
- [Security & Limits](#security--limits)
|
|
21
|
-
- [License](#license)
|
|
22
|
-
|
|
23
|
-
## Features
|
|
24
|
-
|
|
25
|
-
- **Dynamic spec ingestion** — loads OpenAPI 3.0.x and 3.1.x specs (JSON or YAML) from a local file path or a remote `http(s)://` URL at startup.
|
|
26
|
-
- **Zero glue code** — every operation in the spec becomes an MCP tool automatically; there is nothing to code per endpoint.
|
|
27
|
-
- **Type-safe input schemas** — path, query, header, and cookie parameters become top-level tool properties; the request body is exposed as a `body` property. Required fields are enforced.
|
|
28
|
-
- **Draft-07 compatible schema normalization** — OpenAPI 3.0 constructs such as `nullable: true` and boolean `exclusiveMinimum`/`exclusiveMaximum` are converted to JSON Schema the MCP/LLM layer understands.
|
|
29
|
-
- **`$ref` resolution** — local component references (`#/components/schemas/...`) are dereferenced recursively, with cycle and depth guards.
|
|
30
|
-
- **Input validation** — LLM-supplied arguments are validated against the generated JSON Schema with AJV (formats included) _before_ any network call; validation failures are returned as readable tool errors.
|
|
31
|
-
- **Automatic HTTP execution** — path parameters are URL-encoded and substituted, query/header/cookie parameters are serialized, and request bodies are sent as JSON with the correct `Content-Type`.
|
|
32
|
-
- **Header-based authentication** — inject static credentials via `API_AUTH_HEADERS`/`API_HEADERS` (or `-H`) when fetching the spec and calling API endpoints. Configured headers are not added to tool schemas.
|
|
33
|
-
- **Base URL override** — point the bridge at a different environment (staging, a local mock, an authenticated proxy) without editing the spec.
|
|
34
|
-
- **Optional response limits** — configure depth, array length, string length, and serialized character budgets. Limits are unlimited by default; tool responses flag truncation.
|
|
35
|
-
- **Built-in `health` tool** — a no-op bootstrap tool to verify the server is responding.
|
|
36
|
-
- **Failure handling** — invalid specifications prevent startup. Invalid tool arguments, network failures, and HTTP 4xx/5xx responses produce MCP tool errors.
|
|
37
|
-
- **Insecure HTTP allowed** — optional flag to permit plain `http://` targets.
|
|
38
|
-
|
|
39
|
-
## How It Works
|
|
1
|
+
<p align="center">
|
|
2
|
+
<picture>
|
|
3
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo-dark.svg">
|
|
4
|
+
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo.svg">
|
|
5
|
+
<img src="https://raw.githubusercontent.com/mtellami/openwire/master/assets/brand/logo.svg" alt="Openwire" width="460" height="140">
|
|
6
|
+
</picture>
|
|
7
|
+
</p>
|
|
40
8
|
|
|
41
|
-
|
|
42
|
-
OpenAPI spec (file or URL)
|
|
43
|
-
│
|
|
44
|
-
▼
|
|
45
|
-
┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
|
|
46
|
-
│ Spec Loader │───▶│ Parser │───▶│ Schema Builder │
|
|
47
|
-
│ (YAML/JSON, $ref │ │ (3.0/3.1, ops → │ │ (OpenAPI schema → │
|
|
48
|
-
│ dereference) │ │ tool metadata) │ │ MCP JSON Schema) │
|
|
49
|
-
└───────────────────┘ └───────────────────┘ └───────────────────┘
|
|
50
|
-
│
|
|
51
|
-
▼
|
|
52
|
-
┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐
|
|
53
|
-
│ MCP Server │ │ Validator (AJV) │ │ HTTP Executor │
|
|
54
|
-
│ (stdio, one tool │───▶│ (reject bad args) │───▶│ (call the API) │
|
|
55
|
-
│ per operation) │ └───────────────────┘ └─────────┬─────────┘
|
|
56
|
-
└───────────────────┘ ▼
|
|
57
|
-
┌───────────────────┐
|
|
58
|
-
│ Sanitizer │
|
|
59
|
-
│ (bounded response│
|
|
60
|
-
│ for LLM context) │
|
|
61
|
-
└───────────────────┘
|
|
62
|
-
```
|
|
9
|
+
<h1 align="center">Your API. Ready for AI.</h1>
|
|
63
10
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
5. **Validate** — on each tool call, arguments are checked against the input schema with AJV before anything hits the network.
|
|
69
|
-
6. **Execute** — a real HTTP request is built (URL, headers, query, cookies, JSON body) and dispatched with a timeout.
|
|
70
|
-
7. **Sanitize** — the response body is compacted/truncated under configurable budgets and returned to the model, along with the HTTP status.
|
|
11
|
+
<p align="center">
|
|
12
|
+
Turn an OpenAPI specification into validated MCP tools.<br>
|
|
13
|
+
One command. No endpoint wrappers.
|
|
14
|
+
</p>
|
|
71
15
|
|
|
72
|
-
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="https://www.npmjs.com/package/openwire"><img src="https://img.shields.io/npm/v/openwire?style=flat&color=1D9E75" alt="npm version"></a>
|
|
18
|
+
<a href="https://github.com/mtellami/openwire/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/mtellami/openwire/ci.yml?branch=master&style=flat&label=CI" alt="CI status"></a>
|
|
19
|
+
<a href="https://www.npmjs.com/package/openwire"><img src="https://img.shields.io/node/v/openwire?style=flat&color=1D9E75" alt="Node.js requirement"></a>
|
|
20
|
+
<a href="https://github.com/mtellami/openwire/blob/master/LICENSE"><img src="https://img.shields.io/github/license/mtellami/openwire?style=flat&color=1D9E75" alt="MIT license"></a>
|
|
21
|
+
</p>
|
|
73
22
|
|
|
74
|
-
|
|
75
|
-
-
|
|
23
|
+
<p align="center">
|
|
24
|
+
<a href="#quick-start">Quick start</a> ·
|
|
25
|
+
<a href="#connect-your-mcp-client">Client setup</a> ·
|
|
26
|
+
<a href="#how-it-works">Architecture</a> ·
|
|
27
|
+
<a href="#configuration">Configuration</a> ·
|
|
28
|
+
<a href="#compatibility">Compatibility</a> ·
|
|
29
|
+
<a href="https://github.com/mtellami/openwire/blob/master/ROADMAP.md">Roadmap</a>
|
|
30
|
+
</p>
|
|
76
31
|
|
|
77
|
-
|
|
32
|
+
---
|
|
78
33
|
|
|
79
|
-
|
|
80
|
-
npm uninstall -g api-mcp-bridge
|
|
81
|
-
npm install -g openwire
|
|
82
|
-
```
|
|
34
|
+
Openwire is a [Model Context Protocol](https://modelcontextprotocol.io) server for REST APIs. Give it a local OpenAPI file or a remote specification URL, and it exposes API operations as tools that an MCP client can discover and call over **stdio**.
|
|
83
35
|
|
|
84
|
-
|
|
36
|
+
Use it to connect an existing API to an AI assistant, point the same tools at staging or a local mock, or explore an API without maintaining a separate integration for every endpoint.
|
|
85
37
|
|
|
86
|
-
|
|
38
|
+
## Why Openwire
|
|
87
39
|
|
|
88
|
-
|
|
40
|
+
| Capability | What you get |
|
|
41
|
+
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
42
|
+
| **Tools from your spec** | Operation names, descriptions, parameters, and JSON request bodies become tool definitions at startup. |
|
|
43
|
+
| **Validation before execution** | Arguments are checked against generated schemas with AJV, including supported string formats, before an API request is made. |
|
|
44
|
+
| **Configured authentication** | Inject static authorization or proxy headers into spec downloads and API requests. |
|
|
45
|
+
| **Control over responses** | Opt into depth, array, string, and serialized character limits to manage model context usage. |
|
|
46
|
+
| **Predictable failures** | Validation failures, network errors, and HTTP 4xx/5xx responses are returned as MCP tool errors. |
|
|
47
|
+
| **A small runtime** | Node.js, built-in `fetch`, and a stdio connection. No separate HTTP service to deploy. |
|
|
89
48
|
|
|
90
|
-
|
|
49
|
+
## Quick start
|
|
91
50
|
|
|
92
|
-
|
|
51
|
+
**Requirements:** Node.js **20.19 or newer** and an OpenAPI **3.0.x or 3.1.x** specification. See [compatibility](#compatibility) for supported features.
|
|
93
52
|
|
|
94
|
-
|
|
95
|
-
npm install -g openwire
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
### Run-on-demand with npx
|
|
53
|
+
Run directly with npx:
|
|
99
54
|
|
|
100
55
|
```bash
|
|
101
|
-
npx openwire --spec ./openapi.yaml
|
|
56
|
+
npx --yes openwire --spec ./openapi.yaml
|
|
102
57
|
```
|
|
103
58
|
|
|
104
|
-
|
|
59
|
+
Or install the CLI:
|
|
105
60
|
|
|
106
61
|
```bash
|
|
107
|
-
npm install
|
|
108
|
-
|
|
109
|
-
npm run start -- --spec ./openapi.yaml
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
## CLI Usage
|
|
113
|
-
|
|
114
|
-
```
|
|
115
|
-
openwire [options] [source]
|
|
62
|
+
npm install -g openwire
|
|
63
|
+
openwire --spec ./openapi.yaml
|
|
116
64
|
```
|
|
117
65
|
|
|
118
|
-
|
|
119
|
-
| ---------------------- | ------------------------------------------------------------------------------------------- |
|
|
120
|
-
| `-s, --spec <src>` | Path to the spec file or an `http(s)://` URL. |
|
|
121
|
-
| `-H, --headers <json>` | JSON object of headers injected into every request (e.g. `{"Authorization":"Bearer ..."}`). |
|
|
122
|
-
| `<src>` (positional) | Same as `--spec`. |
|
|
123
|
-
| `--help` | Show usage. |
|
|
124
|
-
|
|
125
|
-
The spec source can also be provided via the `OPENAPI_SOURCE` environment variable. The CLI flag (or positional argument) takes precedence.
|
|
66
|
+
Remote JSON and YAML specifications work too:
|
|
126
67
|
|
|
127
68
|
```bash
|
|
128
|
-
|
|
129
|
-
openwire --spec ./openapi.yaml
|
|
130
|
-
|
|
131
|
-
# Remote spec URL
|
|
132
|
-
openwire --spec https://api.example.com/openapi.json
|
|
133
|
-
|
|
134
|
-
# Env-driven
|
|
135
|
-
OPENAPI_SOURCE=./openapi.yaml openwire
|
|
69
|
+
npx --yes openwire --spec https://api.example.com/openapi.json
|
|
136
70
|
```
|
|
137
71
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
`openwire` is a **stdio** MCP server, so it plugs into MCP-compatible clients (Claude Desktop, Cursor, VS Code Copilot, homegrown agents, etc.) as a stdio subprocess.
|
|
72
|
+
> Openwire is a stdio subprocess for an MCP client. A terminal waiting for input is expected; connect it to your client to discover and call tools.
|
|
141
73
|
|
|
142
|
-
|
|
74
|
+
## Connect your MCP client
|
|
143
75
|
|
|
144
|
-
|
|
76
|
+
Add Openwire to a client that supports local stdio MCP servers. The following uses the common `mcpServers` configuration format; the file location and settings interface depend on your client.
|
|
145
77
|
|
|
146
78
|
```json
|
|
147
79
|
{
|
|
148
80
|
"mcpServers": {
|
|
149
81
|
"openwire": {
|
|
150
|
-
"command": "
|
|
151
|
-
"args": ["--spec", "/absolute/path/to/openapi.yaml"],
|
|
82
|
+
"command": "npx",
|
|
83
|
+
"args": ["--yes", "openwire", "--spec", "/absolute/path/to/openapi.yaml"],
|
|
152
84
|
"env": {
|
|
153
85
|
"API_BASE_URL": "https://api.example.com"
|
|
154
86
|
}
|
|
@@ -157,126 +89,190 @@ Open `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/
|
|
|
157
89
|
}
|
|
158
90
|
```
|
|
159
91
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
92
|
+
For a global installation, set `"command": "openwire"` and use `"args": ["--spec", "/absolute/path/to/openapi.yaml"]`. For a source checkout, use `"command": "node"` with the absolute path to `dist/index.js` followed by `--spec` and your spec path.
|
|
93
|
+
|
|
94
|
+
Use an absolute local spec path: the client's working directory may differ from your terminal. Restart the connection after changing the specification or configuration; the tool list is built once at startup.
|
|
95
|
+
|
|
96
|
+
## How it works
|
|
97
|
+
|
|
98
|
+
<p align="center">
|
|
99
|
+
<img src="https://raw.githubusercontent.com/mtellami/openwire/master/assets/diagrams/architecture.svg" alt="At startup, Openwire loads an OpenAPI specification and builds MCP tools. At runtime, a client calls a tool, Openwire validates arguments, calls the REST API, and returns a compacted response." width="960" height="360">
|
|
100
|
+
</p>
|
|
101
|
+
|
|
102
|
+
At startup, Openwire loads the spec, resolves supported local references, normalizes schemas, and registers a tool for each operation plus a built-in `health` tool. At runtime, it validates arguments, builds and executes the HTTP request, then compacts the response under any configured limits.
|
|
103
|
+
|
|
104
|
+
### From endpoint to tool
|
|
105
|
+
|
|
106
|
+
Given this operation:
|
|
107
|
+
|
|
108
|
+
```yaml
|
|
109
|
+
openapi: 3.0.3
|
|
110
|
+
info:
|
|
111
|
+
title: Pet API
|
|
112
|
+
version: 1.0.0
|
|
113
|
+
servers:
|
|
114
|
+
- url: https://api.example.com
|
|
115
|
+
paths:
|
|
116
|
+
/pets/{petId}:
|
|
117
|
+
get:
|
|
118
|
+
operationId: getPetById
|
|
119
|
+
summary: Find a pet by ID
|
|
120
|
+
parameters:
|
|
121
|
+
- name: petId
|
|
122
|
+
in: path
|
|
123
|
+
required: true
|
|
124
|
+
schema:
|
|
125
|
+
type: string
|
|
126
|
+
responses:
|
|
127
|
+
"200":
|
|
128
|
+
description: A pet record
|
|
171
129
|
```
|
|
172
130
|
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
Use plain `node`:
|
|
131
|
+
Openwire exposes a `getPetById` tool. Calling it with:
|
|
176
132
|
|
|
177
133
|
```json
|
|
178
|
-
{
|
|
179
|
-
"mcpServers": {
|
|
180
|
-
"openwire": {
|
|
181
|
-
"command": "node",
|
|
182
|
-
"args": ["/path/to/openwire/dist/index.js", "--spec", "./openapi.yaml"]
|
|
183
|
-
}
|
|
184
|
-
}
|
|
185
|
-
}
|
|
134
|
+
{ "petId": "pet-123" }
|
|
186
135
|
```
|
|
187
136
|
|
|
188
|
-
|
|
137
|
+
makes a `GET https://api.example.com/pets/pet-123` request. A successful response is returned as text with its HTTP status, for example:
|
|
189
138
|
|
|
190
|
-
|
|
139
|
+
```text
|
|
140
|
+
HTTP 200 OK
|
|
141
|
+
{"id":"pet-123","name":"Rex"}
|
|
142
|
+
```
|
|
191
143
|
|
|
192
|
-
|
|
144
|
+
| Mapping | Behavior |
|
|
145
|
+
| -------------- | ---------------------------------------------------------------------------------------------------------------- |
|
|
146
|
+
| Tool name | Normalize `operationId` to camelCase; fall back to the method and path. Collisions receive numeric suffixes. |
|
|
147
|
+
| Tool arguments | Path, query, header, and cookie parameters become top-level properties. Unknown arguments are rejected. |
|
|
148
|
+
| Request body | Expose JSON payloads under `body`; require it when the spec does. |
|
|
149
|
+
| Base URL | Use operation, path, then document servers, unless `API_BASE_URL` is set. |
|
|
150
|
+
| Health check | The reserved `health` tool accepts an optional `echo` string. An API operation named `health` becomes `health2`. |
|
|
193
151
|
|
|
194
|
-
|
|
195
|
-
| ---------------------------- | --------------- | -------------------------------------------------------------------------------------------------- |
|
|
196
|
-
| `OPENAPI_SOURCE` | _(required)_ | Spec path or `http(s)://` URL to load at startup. |
|
|
197
|
-
| `OPENAPI_MAX_TOOLS` | `100` | Maximum number of MCP tools generated from the spec. |
|
|
198
|
-
| `API_BASE_URL` | from spec | Overrides the selected operation, path, or document server URL for every request. |
|
|
199
|
-
| `API_TIMEOUT_MS` | `30000` | Per-request timeout for calls to the target API. |
|
|
200
|
-
| `API_MAX_RESPONSE_CHARS` | unlimited | Total character budget for sanitized responses returned to the model. |
|
|
201
|
-
| `SANITIZE_MAX_DEPTH` | unlimited | Max nesting depth kept when compacting JSON responses. |
|
|
202
|
-
| `SANITIZE_MAX_ARRAY_LENGTH` | unlimited | Max number of array elements kept per array. |
|
|
203
|
-
| `SANITIZE_MAX_STRING_LENGTH` | unlimited | Max length of an individual string value. |
|
|
204
|
-
| `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, or `error`. |
|
|
205
|
-
| `SERVER_NAME` | `openwire` | MCP server name reported to the client. |
|
|
206
|
-
| `SERVER_VERSION` | package version | MCP server version reported to the client. |
|
|
207
|
-
| `ALLOW_INSECURE_HTTP` | `false` | When `true`, permits `http://` spec sources and target APIs; otherwise those requests are refused. |
|
|
208
|
-
| `API_AUTH_HEADERS` | _(none)_ | JSON object of headers injected into every request (e.g. `{"Authorization":"Bearer ..."}`). |
|
|
209
|
-
| `API_HEADERS` | _(none)_ | Same as `API_AUTH_HEADERS`; takes precedence when both are set. |
|
|
152
|
+
## Configuration
|
|
210
153
|
|
|
211
|
-
|
|
154
|
+
```text
|
|
155
|
+
openwire [options] [source]
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
| Argument | Description |
|
|
159
|
+
| ---------------------- | --------------------------------------------------------------- |
|
|
160
|
+
| `-s, --spec <source>` | Local spec path or HTTP(S) URL. Overrides `OPENAPI_SOURCE`. |
|
|
161
|
+
| `<source>` | Positional alternative to `--spec`. |
|
|
162
|
+
| `-H, --headers <json>` | JSON object of headers. Overrides header environment variables. |
|
|
163
|
+
| `-h, --help` | Print CLI usage and available environment settings. |
|
|
164
|
+
|
|
165
|
+
### Environment variables
|
|
166
|
+
|
|
167
|
+
| Variable | Default | Purpose |
|
|
168
|
+
| ---------------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
|
|
169
|
+
| `OPENAPI_SOURCE` | Required without a CLI source | Local spec path or HTTP(S) URL. |
|
|
170
|
+
| `API_BASE_URL` | Selected server from the spec | Override the base URL for every API call. |
|
|
171
|
+
| `API_TIMEOUT_MS` | `30000` | Timeout in milliseconds for spec downloads and API requests. |
|
|
172
|
+
| `OPENAPI_MAX_TOOLS` | `100` | Maximum number of spec operations. Specs above this limit are rejected; `health` is additional. |
|
|
173
|
+
| `API_HEADERS` | Unset | JSON header map sent on spec downloads and API requests. |
|
|
174
|
+
| `API_AUTH_HEADERS` | Unset | Header map fallback; `API_HEADERS` takes precedence. |
|
|
175
|
+
| `API_MAX_RESPONSE_CHARS` | Unlimited | Serialized response-body character budget. |
|
|
176
|
+
| `SANITIZE_MAX_DEPTH` | Unlimited | Maximum JSON nesting depth retained; root depth is zero. |
|
|
177
|
+
| `SANITIZE_MAX_ARRAY_LENGTH` | Unlimited | Maximum number of elements retained per array. |
|
|
178
|
+
| `SANITIZE_MAX_STRING_LENGTH` | Unlimited | String content retained before an optional truncation marker. |
|
|
179
|
+
| `ALLOW_INSECURE_HTTP` | `false` | Permit plain HTTP for spec downloads and API requests. |
|
|
180
|
+
| `LOG_LEVEL` | `info` | `debug`, `info`, `warn`, or `error`. Logs go to stderr. |
|
|
181
|
+
| `SERVER_NAME` | `openwire` | MCP server identity reported to the client. |
|
|
182
|
+
| `SERVER_VERSION` | Package version | MCP server version reported to the client. |
|
|
183
|
+
|
|
184
|
+
### Authenticate requests
|
|
185
|
+
|
|
186
|
+
Configure precomputed Bearer tokens, Basic authorization values, API-key headers, or custom proxy headers:
|
|
212
187
|
|
|
213
188
|
```bash
|
|
214
|
-
export
|
|
215
|
-
|
|
216
|
-
export API_TIMEOUT_MS=15000
|
|
217
|
-
export API_MAX_RESPONSE_CHARS=50000
|
|
218
|
-
export LOG_LEVEL=debug
|
|
219
|
-
openwire
|
|
189
|
+
export API_HEADERS='{"Authorization":"Bearer YOUR_TOKEN","X-API-Key":"YOUR_KEY"}'
|
|
190
|
+
openwire --spec https://api.example.com/openapi.json
|
|
220
191
|
```
|
|
221
192
|
|
|
222
|
-
|
|
193
|
+
For client-managed subprocesses, put `API_HEADERS` in the client's `env` configuration. Keep real credentials out of committed configuration files.
|
|
223
194
|
|
|
224
|
-
|
|
195
|
+
Header precedence is **`--headers` → `API_HEADERS` → `API_AUTH_HEADERS`**: the highest-priority value replaces the entire header map. Configured headers override same-name header parameters supplied in a tool call.
|
|
225
196
|
|
|
226
|
-
|
|
197
|
+
The same headers are sent to the spec URL and the selected API server, so use trusted endpoints. Security schemes are metadata: Openwire does not perform OAuth/OpenID flows, refresh tokens, or automatically inject query/cookie API keys. Use a suitable proxy or restart with updated static credentials when tokens rotate.
|
|
227
198
|
|
|
228
|
-
|
|
199
|
+
### Manage response size
|
|
200
|
+
|
|
201
|
+
Limits are opt-in. For example:
|
|
229
202
|
|
|
230
203
|
```bash
|
|
231
|
-
export
|
|
232
|
-
export
|
|
233
|
-
|
|
204
|
+
export API_MAX_RESPONSE_CHARS=20000
|
|
205
|
+
export SANITIZE_MAX_DEPTH=8
|
|
206
|
+
export SANITIZE_MAX_ARRAY_LENGTH=50
|
|
207
|
+
export SANITIZE_MAX_STRING_LENGTH=2000
|
|
208
|
+
openwire --spec ./openapi.yaml
|
|
234
209
|
```
|
|
235
210
|
|
|
236
|
-
|
|
211
|
+
The character budget includes JSON escaping, punctuation, and embedded markers. HTTP status lines and the separate `[response truncated]` notice sit outside that budget. JSON remains valid when a value fits; otherwise the response body is empty.
|
|
212
|
+
|
|
213
|
+
Responses are buffered before sanitization. These options limit output to the client, rather than download size or peak memory usage.
|
|
214
|
+
|
|
215
|
+
### Use a local API
|
|
237
216
|
|
|
238
217
|
```bash
|
|
239
|
-
|
|
218
|
+
export API_BASE_URL=http://localhost:8080
|
|
219
|
+
export ALLOW_INSECURE_HTTP=true
|
|
220
|
+
openwire --spec ./openapi.yaml
|
|
240
221
|
```
|
|
241
222
|
|
|
242
|
-
|
|
223
|
+
## Compatibility
|
|
243
224
|
|
|
244
|
-
|
|
225
|
+
| Area | Current support |
|
|
226
|
+
| ----------------- | ----------------------------------------------------------------------------------------------------- |
|
|
227
|
+
| Transport | Local stdio MCP server. |
|
|
228
|
+
| Specifications | OpenAPI 3.0.x and 3.1.x, JSON or YAML, local file or HTTP(S) source. |
|
|
229
|
+
| Schema validation | AJV draft-07 with OpenAPI 3.0 normalization; full JSON Schema 2020-12 semantics are not implemented. |
|
|
230
|
+
| References | Supported local references; external references and recursive schema cycles are rejected. |
|
|
231
|
+
| Request bodies | `application/json` and `application/*+json`; other encodings return an error when a body is supplied. |
|
|
232
|
+
| Parameters | Scalar/JSON serialization; OpenAPI `style` and `explode` are not fully implemented. |
|
|
233
|
+
| Servers | Operation/path/document precedence and a global override; server variables are not expanded. |
|
|
234
|
+
| Authentication | Static HTTP headers; no token acquisition or refresh. |
|
|
245
235
|
|
|
246
|
-
|
|
236
|
+
Parameter names share one argument namespace. Duplicate names across locations, or a parameter named `body`, can collide with the request-body argument.
|
|
247
237
|
|
|
248
|
-
|
|
238
|
+
Plain HTTP is refused by default. Configured credentials are not added to tool schemas, and logs omit request headers; upstream response bodies can still echo sensitive information. Invalid specifications prevent initialization; invalid arguments, network failures, and HTTP 4xx/5xx responses produce tool errors.
|
|
249
239
|
|
|
250
|
-
|
|
251
|
-
- OpenAPI 3.0 schemas are normalized for draft-07 validation. OpenAPI 3.1 documents are accepted, but full JSON Schema 2020-12 semantics are not implemented.
|
|
252
|
-
- JSON request bodies (`application/json` and `application/*+json`) are supported and preferred. Other body encodings return a clear execution error when a body is supplied.
|
|
253
|
-
- Parameter serialization uses simple scalar/JSON values; OpenAPI `style`/`explode` rules are not fully implemented.
|
|
254
|
-
- Parameter names share one tool namespace; duplicate names across locations or a parameter named `body` can collide with the body argument.
|
|
255
|
-
- Server selection uses operation, path, then document precedence. Server-variable expansion is not implemented.
|
|
240
|
+
## Development
|
|
256
241
|
|
|
257
|
-
|
|
242
|
+
```bash
|
|
243
|
+
git clone https://github.com/mtellami/openwire.git
|
|
244
|
+
cd openwire
|
|
245
|
+
npm ci
|
|
246
|
+
npm run build
|
|
247
|
+
npm start -- --spec ./openapi.yaml
|
|
248
|
+
```
|
|
258
249
|
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
250
|
+
| Command | Purpose |
|
|
251
|
+
| -------------------------------------- | ----------------------------------------------------------------- |
|
|
252
|
+
| `npm run dev -- --spec ./openapi.yaml` | Run the CLI with source watching. |
|
|
253
|
+
| `npm run typecheck` | Check TypeScript types. |
|
|
254
|
+
| `npm run lint` | Lint source files. |
|
|
255
|
+
| `npm run format:check` | Check repository formatting. |
|
|
256
|
+
| `npm test` | Run unit and MCP integration tests. |
|
|
257
|
+
| `npm run test:package` | Build, pack, install, and verify both CLI names and MCP behavior. |
|
|
263
258
|
|
|
264
|
-
|
|
259
|
+
CI runs checks on Node.js **20, 22, and 24**. Brand assets live in [`assets/brand`](https://github.com/mtellami/openwire/tree/master/assets/brand), and README diagrams live in [`assets/diagrams`](https://github.com/mtellami/openwire/tree/master/assets/diagrams). The README uses absolute image URLs so the same branding renders on GitHub and npm.
|
|
265
260
|
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
261
|
+
For bug reports, include your Node.js version, a minimal specification with secrets removed, the command or client configuration, and the observed error. Use [GitHub Issues](https://github.com/mtellami/openwire/issues) for reports and feature requests, or open a pull request with a focused change and relevant validation.
|
|
262
|
+
|
|
263
|
+
## Migrating from api-mcp-bridge
|
|
264
|
+
|
|
265
|
+
```bash
|
|
266
|
+
npm uninstall -g api-mcp-bridge
|
|
267
|
+
npm install -g openwire
|
|
269
268
|
```
|
|
270
269
|
|
|
271
|
-
|
|
270
|
+
Update the MCP command to `openwire`, or use `npx --yes openwire`. Existing environment variable names and CLI arguments remain compatible. The old command is retained as an alias in Openwire 1.2.x; the default server identity is now `openwire`.
|
|
272
271
|
|
|
273
|
-
|
|
274
|
-
- Requests to the target API are made with the built-in `fetch` and a timeout; slow or failing upstreams surface as structured tool errors. Plain `http://` targets are refused unless `ALLOW_INSECURE_HTTP=true`.
|
|
275
|
-
- Configured credentials are injected server-side and are not added to tool schemas. Logs omit request headers, but upstream responses may echo secrets; configure and trust your upstream accordingly.
|
|
276
|
-
- Response limits are opt-in. `API_MAX_RESPONSE_CHARS` bounds the serialized response body, including escaping and embedded markers; HTTP status lines and the separate `[response truncated]` notice are outside that budget. JSON stays valid when a value fits; otherwise the body is empty. Downloads are still buffered before sanitization.
|
|
277
|
-
- Argument validation happens before any external call, rejecting malformed input early.
|
|
278
|
-
- To talk to `http://` endpoints (e.g., local mocks), set `ALLOW_INSECURE_HTTP=true`.
|
|
272
|
+
## Project
|
|
279
273
|
|
|
280
|
-
|
|
274
|
+
- [Changelog](https://github.com/mtellami/openwire/blob/master/CHANGELOG.md) — release history and migration notes.
|
|
275
|
+
- [Roadmap](https://github.com/mtellami/openwire/blob/master/ROADMAP.md) — operation filtering, bounded downloads, OpenAPI compatibility, and authentication improvements.
|
|
276
|
+
- [MIT license](https://github.com/mtellami/openwire/blob/master/LICENSE) — maintained by [Moad Tellami](https://github.com/mtellami).
|
|
281
277
|
|
|
282
|
-
|
|
278
|
+
Openwire is an OpenAPI-to-MCP server, unrelated to the Apache ActiveMQ OpenWire protocol.
|
package/ROADMAP.md
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Openwire optimization roadmap
|
|
2
|
+
|
|
3
|
+
Priorities follow the current implementation review. These features are deferred beyond 1.2.0.
|
|
4
|
+
|
|
5
|
+
| Priority | Improvement | Benefit | Acceptance evidence |
|
|
6
|
+
| -------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
|
|
7
|
+
| 1 | Filter operations by tag, path, method, or operation ID before applying the tool limit | Let large APIs expose a useful subset without overwhelming client context | Deterministic filtered tool lists; excluded operations never register; measure tool-schema size reduction |
|
|
8
|
+
| 2 | Stream and cap spec downloads and API responses before buffering | Bound memory use even when upstream payloads are huge | Byte-accurate limits for UTF-8, streamed responses, and missing Content-Length; benchmark peak memory |
|
|
9
|
+
| 3 | Support parameter style/explode, server variables, recursive schemas, and dialect-aware OpenAPI 3.1 validation | Increase compatibility with real API specifications | Conformance fixtures for each supported feature and explicit errors for unsupported constructs |
|
|
10
|
+
| 4 | Separate spec and API credentials; support explicit query/cookie API-key injection | Avoid sharing credentials between services and support additional authentication layouts | Credential isolation across hosts, redirect tests, and no secret tool-schema exposure |
|
|
11
|
+
| 5 | Benchmark startup and optimize repeated reference resolution/schema compilation | Reduce startup time for larger specifications | Compare cold/warm startup, compile counts, memory, and identical generated schemas before adding caches |
|
|
12
|
+
|
|
13
|
+
Additional correctness work: avoid argument-name collisions between parameter locations and request bodies; validate configuration numbers strictly; expand redirect policy checks and sensitive-URL redaction. Do not add automatic retries for mutating API requests without an explicit idempotency policy.
|
|
14
|
+
|
|
15
|
+
Keep stdio as the default transport. Consider new transports or OAuth token acquisition as separate features with their own compatibility and lifecycle designs.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" xmlns:c2pa="http://c2pa.org/manifest">
|
|
2
|
+
<title>openwire icon</title>
|
|
3
|
+
<rect width="512" height="512" rx="112" fill="#111916"/>
|
|
4
|
+
<g transform="translate(334 256) scale(4)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
|
|
5
|
+
<path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#F1EFE8"/>
|
|
6
|
+
<path d="M-42 0 H-22" stroke="#1D9E75"/>
|
|
7
|
+
<polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
|
|
8
|
+
<circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
|
|
9
|
+
</g>
|
|
10
|
+
<metadata><c2pa:manifest>AAAWgmp1bWIAAAAeanVtZGMycGEAEQAQgAAAqgA4m3EDYzJwYQAAABZcanVtYgAAAEdqdW1kYzJtYQARABCAAACqADibcQN1cm46YzJwYTphYmFlMmZmOC0wYmU4LTQ4MjctYTg4Mi1mMGY3NDk1YWM5NDUAAAADl2p1bWIAAAApanVtZGMyYXMAEQAQgAAAqgA4m3EDYzJwYS5hc3NlcnRpb25zAAAAALxqdW1iAAAARGp1bWRjYm9yABEAEIAAAKoAOJtxE2MycGEuaW5ncmVkaWVudC52MwAAAAAYYzJzaE3BSctaZZImCG0SJfeh9BkAAABwY2JvcqNpZGM6Zm9ybWF0bWltYWdlL3N2Zyt4bWxqaW5zdGFuY2VJRHgseG1wOmlpZDpjNzk1N2ZiYi0wNTVmLTQ1NDAtYjI0Ny1iMzFhM2U0Y2MyMDJscmVsYXRpb25zaGlwaHBhcmVudE9mAAAB4mp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNoLV74T/rjkD+Zbg1CRRJ2hwAAAZljYm9yomdhY3Rpb25zgqJmYWN0aW9ua2MycGEub3BlbmVkanBhcmFtZXRlcnOha2luZ3JlZGllbnRzgaJjdXJseC1zZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmluZ3JlZGllbnQudjNkaGFzaFggsZvkU9mXBCNYqW6BS7d1YQ34QdgKuWOFL55V4yUR9H+kZmFjdGlvbngdY29tLmFudGhyb3BpYy5jbGF1ZGUucHJvdmlkZWRqcGFyYW1ldGVyc6F4H2NvbS5hbnRocm9waWMub3JpZ2luLWNvbmZpZGVuY2VndW5rbm93bmtkZXNjcmlwdGlvbnhmQ2xhdWRlIHByb3ZpZGVkIHRoaXMgZmlsZSBhdCB0aGUgcmVxdWVzdCBvZiBhIHVzZXIgYW5kIG1heSBoYXZlIGNyZWF0ZWQgb3IgbW9kaWZpZWQgdGhlIGZpbGUgY29udGVudHMubXNvZnR3YXJlQWdlbnShZG5hbWVmQ2xhdWRlcmFsbEFjdGlvbnNJbmNsdWRlZPUAAADIanVtYgAAAEBqdW1kY2JvcgARABCAAACqADibcRNjMnBhLmhhc2guZGF0YQAAAAAYYzJzaB0LZf1b0kwBXSbc4YqEWBgAAACAY2JvcqVjYWxnZnNoYTI1NmNwYWRMAAAAAAAAAAAAAAAAZGhhc2hYIL213/lUmPfYLLw1wSeoKoNu1oKjdgp2Yz00Zj7g9/6tZG5hbWVuanVtYmYgbWFuaWZlc3RqZXhjbHVzaW9uc4GiZXN0YXJ0GQKgZmxlbmd0aBkeBAAAAj5qdW1iAAAAJ2p1bWRjMmNsABEAEIAAAKoAOJtxA2MycGEuY2xhaW0udjIAAAACD2Nib3KlY2FsZ2ZzaGEyNTZpc2lnbmF0dXJleE1zZWxmI2p1bWJmPS9jMnBhL3VybjpjMnBhOmFiYWUyZmY4LTBiZTgtNDgyNy1hODgyLWYwZjc0OTVhYzk0NS9jMnBhLnNpZ25hdHVyZWppbnN0YW5jZUlEeCx4bXA6aWlkOjU2OTI5NWU1LTM0NGQtNDgwMS04NjRjLWExMDdmNWNjZWUxN3JjcmVhdGVkX2Fzc2VydGlvbnODomN1cmx4LXNlbGYjanVtYmY9YzJwYS5hc3NlcnRpb25zL2MycGEuaW5ncmVkaWVudC52M2RoYXNoWCCxm+RT2ZcEI1ipboFLt3VhDfhB2Aq5Y4UvnlXjJRH0f6JjdXJseCpzZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmFjdGlvbnMudjJkaGFzaFggxyl49LE2PPKNnlVsKYm5Hf/lBKtGwOaun3OZ1faW+1iiY3VybHgpc2VsZiNqdW1iZj1jMnBhLmFzc2VydGlvbnMvYzJwYS5oYXNoLmRhdGFkaGFzaFggYhaIzTD+Yt5/mKuSNLTBu24cCMXhMYT/2IgYHd8i2TN0Y2xhaW1fZ2VuZXJhdG9yX2luZm+jZG5hbWVvQW50aHJvcGljIEZpbGVzZ3ZlcnNpb25lMS4wLjBrc3BlY1ZlcnNpb25lMi40LjAAABA4anVtYgAAAChqdW1kYzJjcwARABCAAACqADibcQNjMnBhLnNpZ25hdHVyZQAAABAIY2JvctKEWQISogEmGCFZAgowggIGMIIBjaADAgECAhRA5aAK7sI50L64g/oGQgU9Z1UTADAKBggqhkjOPQQDAzBJMRcwFQYDVQQKEw5BbnRocm9waWMsIFBCQzEuMCwGA1UEAxMlQW50aHJvcGljIENvbnRlbnQgQ3JlZGVudGlhbHMgUm9vdCBDQTAeFw0yNjA4MDcxODQzNTZaFw0yODA4MDYxOTQzNTZaMEQxFzAVBgNVBAoTDkFudGhyb3BpYywgUEJDMSkwJwYDVQQDEyBBbnRocm9waWMgQ2xhdWRlIENvbnRlbnQgU2lnbmluZzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJh6CmvLUBgFFNU0vUKlOVtE6djd17L5SuwX0LemFisBM3dkd/3cyjxFA3Qo5S46fX0/ihY0VZ7mfb9KF703t5OjWDBWMA4GA1UdDwEB/wQEAwIHgDAVBgNVHSUEDjAMBgorBgEEAYPoXgIBMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUzlHiBIFOZFsj+OPEz5o+nMHXXMIwCgYIKoZIzj0EAwMDZwAwZAIwMXMdFJ4BetLLVY7ORuE9noqbbAZOZn/aArXyTwFAZfKrPzxF2vPoJNf1+UCdg1XGAjBwX1zd9WGqYkqmL5SFqw1QySjr1zJfpJM9+1rdDwSPLMOPOjKuiXjoU/pUUeG9RwmhY3BhZFkNngAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPZYQNssFvxnIH8IPMQK7dDKiTfh16wlZpIXOUh/tRELIcipYBEOLXRgRF5IxUMAa1HteytIs6NCEWgwIiTIc5o7QJ4=</c2pa:manifest></metadata></svg>
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="460" height="140" viewBox="0 0 460 140">
|
|
2
|
+
<title>openwire</title>
|
|
3
|
+
<g transform="translate(130 70) scale(1.9)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
|
|
4
|
+
<path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#F1EFE8"/>
|
|
5
|
+
<path d="M-42 0 H-22" stroke="#1D9E75"/>
|
|
6
|
+
<polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
|
|
7
|
+
<circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
|
|
8
|
+
</g>
|
|
9
|
+
<text x="190" y="88" font-family="Inter, Helvetica, Arial, sans-serif" font-size="56" font-weight="500" fill="#F1EFE8">open<tspan fill="#1D9E75">wire</tspan></text>
|
|
10
|
+
</svg>
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="460" height="140" viewBox="0 0 460 140" xmlns:c2pa="http://c2pa.org/manifest">
|
|
2
|
+
<title>openwire</title>
|
|
3
|
+
<g transform="translate(130 70) scale(1.9)" fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="3">
|
|
4
|
+
<path d="M-45 -18 Q-55 -18 -55 -8 V-4 Q-55 0 -61 0 Q-55 0 -55 4 V8 Q-55 18 -45 18" stroke="#2C2C2A"/>
|
|
5
|
+
<path d="M-42 0 H-22" stroke="#1D9E75"/>
|
|
6
|
+
<polygon points="22,0 11,19.1 -11,19.1 -22,0 -11,-19.1 11,-19.1" stroke="#1D9E75"/>
|
|
7
|
+
<circle cx="0" cy="0" r="4" fill="#1D9E75" stroke="none"/>
|
|
8
|
+
</g>
|
|
9
|
+
<text x="190" y="88" font-family="Inter, Helvetica, Arial, sans-serif" font-size="56" font-weight="500" fill="#2C2C2A">open<tspan fill="#1D9E75">wire</tspan></text>
|
|
10
|
+
<metadata><c2pa:manifest>AAAWgmp1bWIAAAAeanVtZGMycGEAEQAQgAAAqgA4m3EDYzJwYQAAABZcanVtYgAAAEdqdW1kYzJtYQARABCAAACqADibcQN1cm46YzJwYToyOTMxN2NkZi01Mjc5LTQwYTktODM5My0wMGFmYmU0MjUzYzQAAAADl2p1bWIAAAApanVtZGMyYXMAEQAQgAAAqgA4m3EDYzJwYS5hc3NlcnRpb25zAAAAALxqdW1iAAAARGp1bWRjYm9yABEAEIAAAKoAOJtxE2MycGEuaW5ncmVkaWVudC52MwAAAAAYYzJzaN3ZYQXQClPTBocAMokXfhgAAABwY2JvcqNpZGM6Zm9ybWF0bWltYWdlL3N2Zyt4bWxqaW5zdGFuY2VJRHgseG1wOmlpZDo0NTlmODM4MS1mZWU1LTQ2NjQtOWRkYy1lMWQwYWI3ZTEyM2RscmVsYXRpb25zaGlwaHBhcmVudE9mAAAB4mp1bWIAAABBanVtZGNib3IAEQAQgAAAqgA4m3ETYzJwYS5hY3Rpb25zLnYyAAAAABhjMnNos79OVmWlsOygRQmHb1NPvwAAAZljYm9yomdhY3Rpb25zgqJmYWN0aW9ua2MycGEub3BlbmVkanBhcmFtZXRlcnOha2luZ3JlZGllbnRzgaJjdXJseC1zZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmluZ3JlZGllbnQudjNkaGFzaFgg1MwYOJtjZb9cUWqHMDhElPULYBDuZC1uAcxT+6vkv/mkZmFjdGlvbngdY29tLmFudGhyb3BpYy5jbGF1ZGUucHJvdmlkZWRqcGFyYW1ldGVyc6F4H2NvbS5hbnRocm9waWMub3JpZ2luLWNvbmZpZGVuY2VndW5rbm93bmtkZXNjcmlwdGlvbnhmQ2xhdWRlIHByb3ZpZGVkIHRoaXMgZmlsZSBhdCB0aGUgcmVxdWVzdCBvZiBhIHVzZXIgYW5kIG1heSBoYXZlIGNyZWF0ZWQgb3IgbW9kaWZpZWQgdGhlIGZpbGUgY29udGVudHMubXNvZnR3YXJlQWdlbnShZG5hbWVmQ2xhdWRlcmFsbEFjdGlvbnNJbmNsdWRlZPUAAADIanVtYgAAAEBqdW1kY2JvcgARABCAAACqADibcRNjMnBhLmhhc2guZGF0YQAAAAAYYzJzaGBwIGmqV9mzu6VCXr//SzQAAACAY2JvcqVjYWxnZnNoYTI1NmNwYWRMAAAAAAAAAAAAAAAAZGhhc2hYIFPeq538hiXmKIpvSG4G2AQZFfZwH2eS94aNIpxABnoIZG5hbWVuanVtYmYgbWFuaWZlc3RqZXhjbHVzaW9uc4GiZXN0YXJ0GQMIZmxlbmd0aBkeBAAAAj5qdW1iAAAAJ2p1bWRjMmNsABEAEIAAAKoAOJtxA2MycGEuY2xhaW0udjIAAAACD2Nib3KlY2FsZ2ZzaGEyNTZpc2lnbmF0dXJleE1zZWxmI2p1bWJmPS9jMnBhL3VybjpjMnBhOjI5MzE3Y2RmLTUyNzktNDBhOS04MzkzLTAwYWZiZTQyNTNjNC9jMnBhLnNpZ25hdHVyZWppbnN0YW5jZUlEeCx4bXA6aWlkOjg3YTg1NTk5LWY2ODktNDI2Mi04MmNhLTQ2OTgyZTA3OTlkM3JjcmVhdGVkX2Fzc2VydGlvbnODomN1cmx4LXNlbGYjanVtYmY9YzJwYS5hc3NlcnRpb25zL2MycGEuaW5ncmVkaWVudC52M2RoYXNoWCDUzBg4m2Nlv1xRaocwOESU9QtgEO5kLW4BzFP7q+S/+aJjdXJseCpzZWxmI2p1bWJmPWMycGEuYXNzZXJ0aW9ucy9jMnBhLmFjdGlvbnMudjJkaGFzaFggtY+k4GdlcAoxXBcYDgU0IyDiXvo2AesW0rWWd1SgfrWiY3VybHgpc2VsZiNqdW1iZj1jMnBhLmFzc2VydGlvbnMvYzJwYS5oYXNoLmRhdGFkaGFzaFggMW9Mcyzz4EidoHSIAnZZmYNsUGCKUqYX7s2u3JadpW50Y2xhaW1fZ2VuZXJhdG9yX2luZm+jZG5hbWVvQW50aHJvcGljIEZpbGVzZ3ZlcnNpb25lMS4wLjBrc3BlY1ZlcnNpb25lMi40LjAAABA4anVtYgAAAChqdW1kYzJjcwARABCAAACqADibcQNjMnBhLnNpZ25hdHVyZQAAABAIY2JvctKEWQISogEmGCFZAgowggIGMIIBjaADAgECAhRA5aAK7sI50L64g/oGQgU9Z1UTADAKBggqhkjOPQQDAzBJMRcwFQYDVQQKEw5BbnRocm9waWMsIFBCQzEuMCwGA1UEAxMlQW50aHJvcGljIENvbnRlbnQgQ3JlZGVudGlhbHMgUm9vdCBDQTAeFw0yNjA4MDcxODQzNTZaFw0yODA4MDYxOTQzNTZaMEQxFzAVBgNVBAoTDkFudGhyb3BpYywgUEJDMSkwJwYDVQQDEyBBbnRocm9waWMgQ2xhdWRlIENvbnRlbnQgU2lnbmluZzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABJh6CmvLUBgFFNU0vUKlOVtE6djd17L5SuwX0LemFisBM3dkd/3cyjxFA3Qo5S46fX0/ihY0VZ7mfb9KF703t5OjWDBWMA4GA1UdDwEB/wQEAwIHgDAVBgNVHSUEDjAMBgorBgEEAYPoXgIBMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUzlHiBIFOZFsj+OPEz5o+nMHXXMIwCgYIKoZIzj0EAwMDZwAwZAIwMXMdFJ4BetLLVY7ORuE9noqbbAZOZn/aArXyTwFAZfKrPzxF2vPoJNf1+UCdg1XGAjBwX1zd9WGqYkqmL5SFqw1QySjr1zJfpJM9+1rdDwSPLMOPOjKuiXjoU/pUUeG9RwmhY3BhZFkNngAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAPZYQDMqnM3ulviHK0qUGy/Nhv2dIv3nl3t02pwVEszMNTj2q47Eq06A4bjkq0XqmiBXJDykeVRcBMa66NCR79kfm84=</c2pa:manifest></metadata></svg>
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="960" height="360" viewBox="0 0 960 360" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">Openwire architecture</title>
|
|
3
|
+
<desc id="desc">At startup, an OpenAPI specification is parsed into validated MCP tools. During a tool call, Openwire validates arguments, calls the REST API, and returns the compacted response to the MCP client.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto-start-reverse"><path d="M0 0L8 4L0 8" fill="none" stroke="#60766c" stroke-width="1.5"/></marker>
|
|
6
|
+
</defs>
|
|
7
|
+
<rect x="1" y="1" width="958" height="358" rx="20" fill="#f8faf9" stroke="#dce7e1"/>
|
|
8
|
+
<g font-family="Inter, Helvetica, Arial, sans-serif">
|
|
9
|
+
<text x="36" y="35" font-size="11" font-weight="700" letter-spacing="2" fill="#52655c">STARTUP</text>
|
|
10
|
+
<rect x="36" y="53" width="230" height="64" rx="12" fill="#fff" stroke="#d0ded6"/>
|
|
11
|
+
<text x="56" y="79" font-size="16" font-weight="600" fill="#182d22">OpenAPI specification</text>
|
|
12
|
+
<text x="56" y="101" font-size="12" fill="#52655c">File or URL · JSON / YAML</text>
|
|
13
|
+
<path d="M268 85H321" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
|
|
14
|
+
<rect x="333" y="53" width="267" height="64" rx="12" fill="#eaf6f0" stroke="#82bfa5"/>
|
|
15
|
+
<text x="353" y="79" font-size="16" font-weight="600" fill="#182d22">Parse and build schemas</text>
|
|
16
|
+
<text x="353" y="101" font-size="12" fill="#52655c">Resolve local references · map operations</text>
|
|
17
|
+
<path d="M602 85H656" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
|
|
18
|
+
<rect x="668" y="53" width="256" height="64" rx="12" fill="#fff" stroke="#d0ded6"/>
|
|
19
|
+
<text x="688" y="79" font-size="16" font-weight="600" fill="#182d22">Register MCP tools</text>
|
|
20
|
+
<text x="688" y="101" font-size="12" fill="#52655c">One per operation + health</text>
|
|
21
|
+
<path d="M36 143H924" stroke="#dce7e1"/>
|
|
22
|
+
<text x="36" y="175" font-size="11" font-weight="700" letter-spacing="2" fill="#52655c">TOOL CALL</text>
|
|
23
|
+
<rect x="36" y="195" width="190" height="74" rx="12" fill="#fff" stroke="#d0ded6"/>
|
|
24
|
+
<text x="56" y="225" font-size="16" font-weight="600" fill="#182d22">MCP client</text>
|
|
25
|
+
<text x="56" y="248" font-size="12" fill="#52655c">Call a tool over stdio</text>
|
|
26
|
+
<path d="M228 231H283" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
|
|
27
|
+
<rect x="295" y="195" width="320" height="74" rx="12" fill="#111916"/>
|
|
28
|
+
<text x="315" y="225" font-size="16" font-weight="600" fill="#f1efe8">Openwire</text>
|
|
29
|
+
<text x="315" y="248" font-size="12" fill="#b6d4c5">Validate arguments → build HTTP request</text>
|
|
30
|
+
<path d="M617 231H720" stroke="#60766c" stroke-width="1.5" marker-end="url(#arrow)"/>
|
|
31
|
+
<text x="646" y="216" font-size="11" fill="#52655c">HTTP(S)</text>
|
|
32
|
+
<rect x="732" y="195" width="192" height="74" rx="12" fill="#fff" stroke="#d0ded6"/>
|
|
33
|
+
<text x="752" y="225" font-size="16" font-weight="600" fill="#182d22">Your REST API</text>
|
|
34
|
+
<text x="752" y="248" font-size="12" fill="#52655c">Execute the operation</text>
|
|
35
|
+
<path d="M828 271V318H133V281" stroke="#1d9e75" stroke-width="1.5" fill="none" marker-end="url(#arrow)"/>
|
|
36
|
+
<rect x="273" y="302" width="420" height="28" rx="14" fill="#eaf6f0"/>
|
|
37
|
+
<text x="483" y="321" text-anchor="middle" font-size="12" font-weight="500" fill="#176c50">HTTP status + compacted body · optional response limits</text>
|
|
38
|
+
</g>
|
|
39
|
+
</svg>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openwire",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.1",
|
|
4
4
|
"description": "OpenAPI-to-MCP server: turn API specifications into validated tools for AI clients.",
|
|
5
5
|
"author": "Moad Tellami",
|
|
6
6
|
"license": "MIT",
|
|
@@ -42,7 +42,10 @@
|
|
|
42
42
|
"api-mcp-bridge": "dist/index.js"
|
|
43
43
|
},
|
|
44
44
|
"files": [
|
|
45
|
-
"dist"
|
|
45
|
+
"dist",
|
|
46
|
+
"assets",
|
|
47
|
+
"CHANGELOG.md",
|
|
48
|
+
"ROADMAP.md"
|
|
46
49
|
],
|
|
47
50
|
"scripts": {
|
|
48
51
|
"dev": "tsx watch src/index.ts",
|