@manifest-network/manifest-mcp-fred 0.2.3 → 0.3.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.
Files changed (2) hide show
  1. package/README.md +66 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # @manifest-network/manifest-mcp-fred
2
+
3
+ MCP server for Manifest provider (Fred) operations. Registers 8 tools for app deployment, status, logs, restart, update, diagnostics, and releases. Composes on-chain operations with off-chain provider HTTP calls using ADR-036 authentication.
4
+
5
+ This package also **exports all tool functions and HTTP clients** for use by library consumers without requiring the MCP protocol.
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ npm install @manifest-network/manifest-mcp-fred
11
+ ```
12
+
13
+ ## Tools
14
+
15
+ | Tool | Description |
16
+ |------|-------------|
17
+ | `browse_catalog` | Browse available providers and service tiers with health checks |
18
+ | `deploy_app` | Deploy a new application (create lease + deploy container) |
19
+ | `app_status` | Get detailed status for a deployed app by lease UUID |
20
+ | `get_logs` | Get logs for a deployed app by lease UUID |
21
+ | `restart_app` | Restart a deployed app via the provider |
22
+ | `update_app` | Update a deployed app with a new manifest |
23
+ | `app_diagnostics` | Get provision diagnostics for a deployed app |
24
+ | `app_releases` | Get release/version history for a deployed app |
25
+
26
+ ## Usage
27
+
28
+ ### As an MCP server (via node package)
29
+
30
+ See [`packages/node/README.md`](https://github.com/manifest-network/manifest-mcp-mono/blob/main/packages/node/README.md) for CLI usage and MCP client integration.
31
+
32
+ ### As a library
33
+
34
+ ```typescript
35
+ // Use the MCP server class
36
+ import { FredMCPServer } from '@manifest-network/manifest-mcp-fred';
37
+
38
+ const server = new FredMCPServer({
39
+ config, // ManifestMCPConfig from core
40
+ walletProvider, // WalletProvider from core
41
+ });
42
+
43
+ // Or use individual tool functions and HTTP clients directly
44
+ import { deployApp, browseCatalog } from '@manifest-network/manifest-mcp-fred';
45
+ import { createAuthToken } from '@manifest-network/manifest-mcp-fred';
46
+ ```
47
+
48
+ ### HTTP clients
49
+
50
+ The package contains three HTTP client modules:
51
+
52
+ - **`http/auth.ts`** -- ADR-036 token construction. Pure functions that build sign messages and assemble base64 bearer tokens. No network calls.
53
+ - **`http/provider.ts`** -- Provider API client: `uploadLeaseData()`, `getLeaseConnectionInfo()`, `getProviderHealth()`. All provider URLs require HTTPS (localhost HTTP allowed for development).
54
+ - **`http/fred.ts`** -- Fred API client: `getLeaseStatus()`, `getLeaseLogs()`, `getLeaseProvision()`, `restartLease()`, `updateLease()`, `getLeaseReleases()`, `getLeaseInfo()`, and `pollLeaseUntilReady()`.
55
+
56
+ ## Build
57
+
58
+ ```bash
59
+ npm run build # tsdown (platform: neutral)
60
+ npm run lint # tsc --noEmit
61
+ npm run test # vitest
62
+ ```
63
+
64
+ ## License
65
+
66
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@manifest-network/manifest-mcp-fred",
3
- "version": "0.2.3",
3
+ "version": "0.3.0",
4
4
  "description": "MCP server for Manifest provider (Fred) operations (deploy, status, logs, restart, update)",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -46,7 +46,7 @@
46
46
  ],
47
47
  "dependencies": {
48
48
  "@cosmjs/encoding": "0.32.4",
49
- "@manifest-network/manifest-mcp-core": "^0.2.3",
49
+ "@manifest-network/manifest-mcp-core": "^0.3.0",
50
50
  "@modelcontextprotocol/sdk": "1.27.1",
51
51
  "zod": "^4.3.6"
52
52
  },