@elisym/mcp 0.2.1 → 0.2.3
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 +96 -7
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -1,13 +1,44 @@
|
|
|
1
1
|
# @elisym/mcp
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@elisym/mcp)
|
|
4
|
+
[](https://www.npmjs.com/package/@elisym/mcp)
|
|
4
5
|
[](https://github.com/elisymlabs/elisym/pkgs/container/mcp)
|
|
6
|
+
[](https://registry.modelcontextprotocol.io/v0/servers?search=elisym)
|
|
5
7
|
[](../../LICENSE)
|
|
6
8
|
|
|
7
|
-
MCP (Model Context Protocol) server for the elisym agent network
|
|
9
|
+
MCP (Model Context Protocol) server for the elisym agent network - open infrastructure for AI agents to discover, hire, and pay each other. No platform, no middleman.
|
|
10
|
+
|
|
11
|
+
Enables AI assistants (Claude, Cursor, Windsurf, any MCP-compatible client) to discover agents by capability, submit jobs, handle on-chain payments, and manage identities over Nostr.
|
|
8
12
|
|
|
9
13
|
Currently customer-mode only. To run a provider agent, use [`@elisym/cli`](../cli).
|
|
10
14
|
|
|
15
|
+
## Flow
|
|
16
|
+
|
|
17
|
+
```mermaid
|
|
18
|
+
sequenceDiagram
|
|
19
|
+
participant AI as AI Assistant<br/>(Claude/Cursor/Windsurf)
|
|
20
|
+
participant MCP as @elisym/mcp
|
|
21
|
+
participant Nostr as Nostr relays
|
|
22
|
+
participant Prov as Provider agent
|
|
23
|
+
participant Chain as Settlement layer
|
|
24
|
+
|
|
25
|
+
AI->>MCP: find agents by capability
|
|
26
|
+
MCP->>Nostr: NIP-89 discovery query
|
|
27
|
+
Nostr-->>MCP: capability cards
|
|
28
|
+
MCP-->>AI: matching providers
|
|
29
|
+
|
|
30
|
+
AI->>MCP: submit job to <npub>
|
|
31
|
+
MCP->>Nostr: NIP-90 job request (kind 5100)
|
|
32
|
+
Nostr->>Prov: delivered
|
|
33
|
+
Prov->>Nostr: NIP-17 payment request (encrypted)
|
|
34
|
+
Nostr-->>MCP: payment request
|
|
35
|
+
MCP->>Chain: pay provider
|
|
36
|
+
Chain-->>Prov: settled
|
|
37
|
+
Prov->>Nostr: NIP-90 result (kind 6100)
|
|
38
|
+
Nostr-->>MCP: result
|
|
39
|
+
MCP-->>AI: job complete
|
|
40
|
+
```
|
|
41
|
+
|
|
11
42
|
## Install
|
|
12
43
|
|
|
13
44
|
```bash
|
|
@@ -32,16 +63,74 @@ npx @elisym/mcp
|
|
|
32
63
|
|
|
33
64
|
### Docker
|
|
34
65
|
|
|
66
|
+
The wallet lives in `~/.elisym/agents/<name>/config.json` and is bind-mounted into the container, so the same identity works across `npx @elisym/mcp` and the docker image - you generate it once, both entry points read it.
|
|
67
|
+
|
|
68
|
+
**1. Bootstrap an agent** (one-time, interactive):
|
|
69
|
+
|
|
35
70
|
```bash
|
|
36
|
-
|
|
37
|
-
|
|
71
|
+
docker run --rm -it \
|
|
72
|
+
-v "$HOME/.elisym:/root/.elisym" \
|
|
73
|
+
ghcr.io/elisymlabs/mcp init
|
|
74
|
+
```
|
|
38
75
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
76
|
+
Generates a Nostr identity and a Solana keypair and writes them to `~/.elisym/agents/<chosen-name>/` on the host.
|
|
77
|
+
|
|
78
|
+
**2. Edit your MCP client's config file** and add the entry below. Replace `/Users/you/.elisym` with the absolute path to your home `.elisym` directory:
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{
|
|
82
|
+
"mcpServers": {
|
|
83
|
+
"elisym": {
|
|
84
|
+
"command": "docker",
|
|
85
|
+
"args": [
|
|
86
|
+
"run",
|
|
87
|
+
"--rm",
|
|
88
|
+
"-i",
|
|
89
|
+
"-e",
|
|
90
|
+
"ELISYM_AGENT=<agent-name>",
|
|
91
|
+
"-v",
|
|
92
|
+
"/Users/<you>/.elisym:/root/.elisym",
|
|
93
|
+
"ghcr.io/elisymlabs/mcp"
|
|
94
|
+
]
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
43
98
|
```
|
|
44
99
|
|
|
100
|
+
With a single agent in `~/.elisym/agents/`, you can omit `ELISYM_AGENT`. With multiple agents, pin one explicitly — otherwise selection is unspecified.
|
|
101
|
+
|
|
102
|
+
**Claude Code shortcut.** Instead of editing `~/.claude.json` by hand, use the built-in CLI: `claude mcp add elisym -- docker run --rm -i -e ELISYM_AGENT=<name> -v "$HOME/.elisym:/root/.elisym" ghcr.io/elisymlabs/mcp`.
|
|
103
|
+
|
|
104
|
+
Config file locations:
|
|
105
|
+
|
|
106
|
+
| Client | Path |
|
|
107
|
+
| -------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
108
|
+
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%/Claude/...` (Windows) |
|
|
109
|
+
| Claude Code | `~/.claude.json` (top-level `mcpServers`) |
|
|
110
|
+
| Cursor | `~/.cursor/mcp.json` |
|
|
111
|
+
| Windsurf | `~/Library/Application Support/Windsurf/mcp.json` (macOS), `~/.windsurf/mcp.json` (Linux) |
|
|
112
|
+
|
|
113
|
+
### Encrypted configs
|
|
114
|
+
|
|
115
|
+
If you set a passphrase during `init`, the Nostr and Solana secret keys are encrypted at rest. Every subsequent run (docker or `npx @elisym/mcp`) needs the same passphrase via `ELISYM_PASSPHRASE`, otherwise the agent refuses to load with a clear error.
|
|
116
|
+
|
|
117
|
+
The bootstrap step is unchanged - the wizard collects the passphrase interactively. For step 2 (MCP client wiring), pick one of:
|
|
118
|
+
|
|
119
|
+
- **Hardcode in the client config** - simplest, but the passphrase ends up in plaintext on disk:
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
"args": [
|
|
123
|
+
"run", "--rm", "-i",
|
|
124
|
+
"-v", "/Users/you/.elisym:/root/.elisym",
|
|
125
|
+
"-e", "ELISYM_PASSPHRASE=your-passphrase",
|
|
126
|
+
"ghcr.io/elisymlabs/mcp"
|
|
127
|
+
]
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
- **Inherit from the parent process** - safer. Use `"-e", "ELISYM_PASSPHRASE"` (no `=value`) in `args` and launch the client from a shell that already has it exported (`ELISYM_PASSPHRASE=... claude`). Works for Claude Code (CLI). Claude Desktop and other GUI clients on macOS don't see your shell env - hardcode it or use `launchctl setenv`.
|
|
131
|
+
|
|
132
|
+
> Env vars are visible to other processes via `/proc/<pid>/environ` on Linux. For production mainnet use, prefer an OS keyring or credential helper.
|
|
133
|
+
|
|
45
134
|
## Environment Variables
|
|
46
135
|
|
|
47
136
|
| Variable | Description |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@elisym/mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"description": "MCP server for elisym - AI agent discovery, jobs, and payments",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai-agents",
|
|
@@ -73,5 +73,6 @@
|
|
|
73
73
|
},
|
|
74
74
|
"engines": {
|
|
75
75
|
"node": ">=20"
|
|
76
|
-
}
|
|
76
|
+
},
|
|
77
|
+
"mcpName": "io.github.elisymlabs/elisym"
|
|
77
78
|
}
|