@frontmcp/adapters 0.8.0 → 0.9.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 +50 -20
- package/esm/package.json +3 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,33 +1,63 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @frontmcp/adapters
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
or delegating MCP tools.
|
|
3
|
+
Adapters that extend FrontMCP servers by auto-generating MCP tools from external specifications.
|
|
5
4
|
|
|
6
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/@frontmcp/adapters)
|
|
7
6
|
|
|
8
|
-
|
|
7
|
+
## Install
|
|
9
8
|
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
```bash
|
|
10
|
+
npm install @frontmcp/adapters
|
|
11
|
+
```
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
- README: `libs/adapters/src/openapi/README.md`
|
|
15
|
-
- Demo usage: `apps/demo/src/apps/expenses/index.ts`
|
|
16
|
-
- Example spec (used by the demo): https://frontmcp-test.proxy.beeceptor.com/openapi.json
|
|
13
|
+
## Available Adapters
|
|
17
14
|
|
|
18
|
-
|
|
19
|
-
which handles parameter conflict resolution, multi-security schemes, and request mappers for you.
|
|
15
|
+
### OpenAPI Adapter
|
|
20
16
|
|
|
21
|
-
|
|
17
|
+
Generate MCP tools from an OpenAPI spec. Each operation becomes a tool with Zod input validation and automatic request/response handling.
|
|
22
18
|
|
|
23
19
|
```ts
|
|
20
|
+
import { App } from '@frontmcp/sdk';
|
|
24
21
|
import { OpenapiAdapter } from '@frontmcp/adapters';
|
|
25
22
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
23
|
+
@App({
|
|
24
|
+
id: 'my-app',
|
|
25
|
+
name: 'My App',
|
|
26
|
+
adapters: [
|
|
27
|
+
OpenapiAdapter.init({
|
|
28
|
+
name: 'backend:api',
|
|
29
|
+
url: 'https://api.example.com/openapi.json',
|
|
30
|
+
baseUrl: 'https://api.example.com',
|
|
31
|
+
}),
|
|
32
|
+
],
|
|
33
|
+
})
|
|
34
|
+
export default class MyApp {}
|
|
31
35
|
```
|
|
32
36
|
|
|
33
|
-
|
|
37
|
+
Powered by [`mcp-from-openapi`](https://www.npmjs.com/package/mcp-from-openapi) for parameter conflict resolution, multi-security schemes, and request mappers.
|
|
38
|
+
|
|
39
|
+
> Full guide: [OpenAPI Adapter][docs-openapi]
|
|
40
|
+
|
|
41
|
+
## Docs
|
|
42
|
+
|
|
43
|
+
| Topic | Link |
|
|
44
|
+
| ------------------ | ---------------------------------- |
|
|
45
|
+
| Adapters overview | [Adapters Overview][docs-overview] |
|
|
46
|
+
| OpenAPI adapter | [OpenAPI Adapter][docs-openapi] |
|
|
47
|
+
| Step-by-step guide | [Add OpenAPI Adapter][docs-guide] |
|
|
48
|
+
|
|
49
|
+
## Related Packages
|
|
50
|
+
|
|
51
|
+
- [`@frontmcp/sdk`](../sdk) — core framework
|
|
52
|
+
- [`@frontmcp/testing`](../testing) — E2E testing for adapter-generated tools
|
|
53
|
+
- [`mcp-from-openapi`](https://www.npmjs.com/package/mcp-from-openapi) — underlying OpenAPI-to-MCP engine
|
|
54
|
+
|
|
55
|
+
## License
|
|
56
|
+
|
|
57
|
+
Apache-2.0 — see [LICENSE](../../LICENSE).
|
|
58
|
+
|
|
59
|
+
<!-- links -->
|
|
60
|
+
|
|
61
|
+
[docs-overview]: https://docs.agentfront.dev/frontmcp/adapters/overview
|
|
62
|
+
[docs-openapi]: https://docs.agentfront.dev/frontmcp/adapters/openapi-adapter
|
|
63
|
+
[docs-guide]: https://docs.agentfront.dev/frontmcp/guides/add-openapi-adapter
|
package/esm/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@frontmcp/adapters",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "Adapters for the FrontMCP framework",
|
|
5
5
|
"author": "AgentFront <info@agentfront.dev>",
|
|
6
6
|
"homepage": "https://docs.agentfront.dev",
|
|
@@ -54,8 +54,8 @@
|
|
|
54
54
|
"node": ">=22.0.0"
|
|
55
55
|
},
|
|
56
56
|
"dependencies": {
|
|
57
|
-
"@frontmcp/utils": "0.
|
|
58
|
-
"@frontmcp/sdk": "0.
|
|
57
|
+
"@frontmcp/utils": "0.9.0",
|
|
58
|
+
"@frontmcp/sdk": "0.9.0",
|
|
59
59
|
"zod": "^4.0.0",
|
|
60
60
|
"openapi-types": "^12.1.3",
|
|
61
61
|
"mcp-from-openapi": "2.1.2",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@frontmcp/adapters",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "Adapters for the FrontMCP framework",
|
|
5
5
|
"author": "AgentFront <info@agentfront.dev>",
|
|
6
6
|
"homepage": "https://docs.agentfront.dev",
|
|
@@ -54,8 +54,8 @@
|
|
|
54
54
|
"node": ">=22.0.0"
|
|
55
55
|
},
|
|
56
56
|
"dependencies": {
|
|
57
|
-
"@frontmcp/utils": "0.
|
|
58
|
-
"@frontmcp/sdk": "0.
|
|
57
|
+
"@frontmcp/utils": "0.9.0",
|
|
58
|
+
"@frontmcp/sdk": "0.9.0",
|
|
59
59
|
"zod": "^4.0.0",
|
|
60
60
|
"openapi-types": "^12.1.3",
|
|
61
61
|
"mcp-from-openapi": "2.1.2",
|