mcp-native 0.9.1 → 0.9.2
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/LICENSE +21 -0
- package/README.md +15 -34
- package/package.json +11 -8
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 MCP Native contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -13,23 +13,15 @@
|
|
|
13
13
|
|
|
14
14
|
</div>
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
> still audit their policies, component mappings, permissions, WebView integration, and platform
|
|
20
|
-
> behavior.
|
|
16
|
+
`mcp-native` is the convenient way to use the runtime, A2UI, React Native, mixed-surface, and WebView
|
|
17
|
+
APIs from one package. It re-exports the focused `@mcp-native/*` layers while leaving transport
|
|
18
|
+
adapters as a separate installation choice.
|
|
21
19
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
> migration support; this is not an unqualified A2UI renderer claim. It also re-exports the
|
|
26
|
-
> documented stable MCP Apps `2026-01-26` native host-adapter profile. See the [A2UI profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md), [MCP Apps profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/mcp-apps-compatibility.md), and [standards matrix](https://github.com/pablospaniard/mcp-native/blob/main/docs/standards-compatibility.md).
|
|
20
|
+
The current 0.9 line contains the React Native feature set planned for 1.0 and is ready to try in an
|
|
21
|
+
integration. New work should use A2UI v1 Candidate or the stable MCP Apps `2026-01-26` host flow;
|
|
22
|
+
the custom A2UI 0.1 APIs live under `/legacy` for migration.
|
|
27
23
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
Read the human-oriented [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md)
|
|
31
|
-
and [mixed-surface guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/mixed-surfaces.md)
|
|
32
|
-
before the API examples.
|
|
24
|
+
For the big picture, start with the [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md).
|
|
33
25
|
|
|
34
26
|
## Install
|
|
35
27
|
|
|
@@ -49,20 +41,18 @@ official action envelopes to a host callback; it never selects a return transpor
|
|
|
49
41
|
[complete v1 host-flow example](https://github.com/pablospaniard/mcp-native#a2ui-v1-candidate-host-flow)
|
|
50
42
|
and the [`@mcp-native/react-native` adapter documentation](https://github.com/pablospaniard/mcp-native/tree/main/packages/react-native#a2ui-v1-render-plan-adapter).
|
|
51
43
|
|
|
52
|
-
##
|
|
44
|
+
## Legacy custom `0.1` migration
|
|
53
45
|
|
|
54
46
|
For `0.9.x`, migrate these imports to `mcp-native/legacy`. Root aliases are removed at `1.0.0`;
|
|
55
47
|
the explicit legacy subpath stays frozen for migration and security fixes.
|
|
56
48
|
|
|
57
49
|
```tsx
|
|
50
|
+
import { McpNativeRuntime, createAllowlistActionPolicy, type McpClient } from "mcp-native";
|
|
58
51
|
import {
|
|
59
52
|
McpNativeSurface,
|
|
60
|
-
McpNativeRuntime,
|
|
61
|
-
createAllowlistActionPolicy,
|
|
62
53
|
parseA2uiSurface,
|
|
63
54
|
useMcpNativeActionDispatcher,
|
|
64
|
-
|
|
65
|
-
} from "mcp-native";
|
|
55
|
+
} from "mcp-native/legacy";
|
|
66
56
|
import { Button, Text, TextInput, View } from "react-native";
|
|
67
57
|
|
|
68
58
|
const components = { Button, Text, TextInput, View };
|
|
@@ -127,7 +117,7 @@ Install an individual package instead when you only need one layer.
|
|
|
127
117
|
|
|
128
118
|
Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospaniard/mcp-native/tree/main/packages/mcp) package to connect these APIs to the official MCP TypeScript SDK without forcing that SDK dependency on every `mcp-native` consumer.
|
|
129
119
|
|
|
130
|
-
##
|
|
120
|
+
## Included in the current 0.9 line
|
|
131
121
|
|
|
132
122
|
- transport-independent MCP runtime contracts;
|
|
133
123
|
- isolated migration support for the deprecated custom `0.1` surface;
|
|
@@ -155,19 +145,10 @@ Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospani
|
|
|
155
145
|
- pinned current-protocol integration coverage through the SDK HTTP handler/fetch path;
|
|
156
146
|
- ESM exports, TypeScript declarations, automated tests, and signed npm provenance.
|
|
157
147
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
non-media catalog, typed renderer-local bindings, bounded formatting and validation, host-callback
|
|
163
|
-
actions, required image grants, policy-gated HTTP(S) `openUrl`, and exact installed-subset
|
|
164
|
-
discovery. Release `0.6.0` added bounded consent, expiring/revocable host-owned grants, interactive
|
|
165
|
-
OAuth, scope history, lifecycle coordination, actionable states, and redacted operations. The
|
|
166
|
-
packages intentionally do not claim MCP operations or A2UI features outside their documented
|
|
167
|
-
profiles. Full streaming host integration, transport placement for A2UI capability objects, and
|
|
168
|
-
separate non-blocking Expo Go integration PoCs remain deferred or excluded work. Follow the
|
|
169
|
-
[roadmap](https://github.com/pablospaniard/mcp-native/blob/main/docs/roadmap.md) for exact claim
|
|
170
|
-
boundaries.
|
|
148
|
+
For the release-by-release history, see the
|
|
149
|
+
[changelog](https://github.com/pablospaniard/mcp-native/blob/main/CHANGELOG.md). The runnable
|
|
150
|
+
[Expo Go todo app](../../examples/expo-go-todolist/README.md) shows the main A2UI and React Native
|
|
151
|
+
pieces working together.
|
|
171
152
|
|
|
172
153
|
## Security model
|
|
173
154
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-native",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.2",
|
|
4
4
|
"description": "Convenience package for the MCP Native runtime.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"a2ui",
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
},
|
|
22
22
|
"files": [
|
|
23
23
|
"dist",
|
|
24
|
+
"LICENSE",
|
|
24
25
|
"README.md"
|
|
25
26
|
],
|
|
26
27
|
"type": "module",
|
|
@@ -30,25 +31,27 @@
|
|
|
30
31
|
"exports": {
|
|
31
32
|
".": {
|
|
32
33
|
"types": "./dist/index.d.ts",
|
|
33
|
-
"import": "./dist/index.js"
|
|
34
|
+
"import": "./dist/index.js",
|
|
35
|
+
"default": "./dist/index.js"
|
|
34
36
|
},
|
|
35
37
|
"./legacy": {
|
|
36
38
|
"types": "./dist/legacy.d.ts",
|
|
37
|
-
"import": "./dist/legacy.js"
|
|
39
|
+
"import": "./dist/legacy.js",
|
|
40
|
+
"default": "./dist/legacy.js"
|
|
38
41
|
}
|
|
39
42
|
},
|
|
40
43
|
"publishConfig": {
|
|
41
44
|
"access": "public"
|
|
42
45
|
},
|
|
43
46
|
"dependencies": {
|
|
44
|
-
"@mcp-native/a2ui": "^0.9.
|
|
45
|
-
"@mcp-native/core": "^0.9.
|
|
46
|
-
"@mcp-native/react-native": "^0.9.
|
|
47
|
-
"@mcp-native/webview": "^0.9.
|
|
47
|
+
"@mcp-native/a2ui": "^0.9.2",
|
|
48
|
+
"@mcp-native/core": "^0.9.2",
|
|
49
|
+
"@mcp-native/react-native": "^0.9.2",
|
|
50
|
+
"@mcp-native/webview": "^0.9.2"
|
|
48
51
|
},
|
|
49
52
|
"peerDependencies": {
|
|
50
53
|
"react": ">=18.3.1 <20",
|
|
51
|
-
"react-native": ">=0.
|
|
54
|
+
"react-native": ">=0.86.0 <1"
|
|
52
55
|
},
|
|
53
56
|
"peerDependenciesMeta": {
|
|
54
57
|
"react-native": {
|