@azeth/mcp-server 0.2.7 → 0.2.9
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 +29 -18
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -9,35 +9,31 @@
|
|
|
9
9
|
|
|
10
10
|
MCP (Model Context Protocol) server for Azeth -- the trust, discovery, and payment layer for the machine economy. Provides 32 tools for AI agents to create accounts, make payments, discover services, manage reputation, and communicate via XMTP.
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## Setup
|
|
13
13
|
|
|
14
14
|
No API keys required. A private key is auto-generated and persisted at `~/.azeth/key`. Gas is sponsored automatically.
|
|
15
15
|
|
|
16
|
-
###
|
|
17
|
-
|
|
18
|
-
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
16
|
+
### Install
|
|
19
17
|
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
"mcpServers": {
|
|
23
|
-
"azeth": {
|
|
24
|
-
"command": "npx",
|
|
25
|
-
"args": ["@azeth/mcp-server"]
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
}
|
|
18
|
+
```bash
|
|
19
|
+
npm install -g @azeth/mcp-server
|
|
29
20
|
```
|
|
30
21
|
|
|
31
22
|
### Claude Code
|
|
32
23
|
|
|
33
|
-
|
|
24
|
+
```bash
|
|
25
|
+
claude mcp add azeth -- azeth-mcp
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
### Claude Desktop
|
|
29
|
+
|
|
30
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
34
31
|
|
|
35
32
|
```json
|
|
36
33
|
{
|
|
37
34
|
"mcpServers": {
|
|
38
35
|
"azeth": {
|
|
39
|
-
"command": "
|
|
40
|
-
"args": ["@azeth/mcp-server"]
|
|
36
|
+
"command": "azeth-mcp"
|
|
41
37
|
}
|
|
42
38
|
}
|
|
43
39
|
}
|
|
@@ -53,8 +49,7 @@ For production or to use an existing key, add environment variables:
|
|
|
53
49
|
{
|
|
54
50
|
"mcpServers": {
|
|
55
51
|
"azeth": {
|
|
56
|
-
"command": "
|
|
57
|
-
"args": ["@azeth/mcp-server"],
|
|
52
|
+
"command": "azeth-mcp",
|
|
58
53
|
"env": {
|
|
59
54
|
"AZETH_PRIVATE_KEY": "0x..."
|
|
60
55
|
}
|
|
@@ -156,6 +151,22 @@ Errors include machine-readable codes and recovery suggestions:
|
|
|
156
151
|
|
|
157
152
|
See the [Azeth documentation](https://azeth.ai) for complete tool reference with parameter tables, return values, and example prompts for all 32 tools.
|
|
158
153
|
|
|
154
|
+
## Troubleshooting
|
|
155
|
+
|
|
156
|
+
### "Failed to connect to MCP server"
|
|
157
|
+
|
|
158
|
+
If you used `npx` instead of a global install, `npx` has two problems as an MCP server launcher:
|
|
159
|
+
|
|
160
|
+
1. **Installation prompt blocks stdin** — `npx` prompts "Ok to proceed? (y)" which reads from the same stdin the MCP protocol uses, deadlocking the connection.
|
|
161
|
+
2. **Cold-start download timeout** — First run must download ~142 packages before the server can start. Claude's MCP client times out waiting.
|
|
162
|
+
|
|
163
|
+
Fix by installing globally:
|
|
164
|
+
|
|
165
|
+
```bash
|
|
166
|
+
npm install -g @azeth/mcp-server
|
|
167
|
+
claude mcp add azeth -- azeth-mcp
|
|
168
|
+
```
|
|
169
|
+
|
|
159
170
|
## Development
|
|
160
171
|
|
|
161
172
|
```bash
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azeth/mcp-server",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.9",
|
|
4
4
|
"mcpName": "io.github.azeth-protocol/mcp-server",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "MCP server for the Azeth trust infrastructure — smart accounts, payments, reputation, and discovery tools for AI agents",
|
|
@@ -41,8 +41,8 @@
|
|
|
41
41
|
"clean": "rm -rf dist"
|
|
42
42
|
},
|
|
43
43
|
"dependencies": {
|
|
44
|
-
"@azeth/common": "^0.2.
|
|
45
|
-
"@azeth/sdk": "^0.2.
|
|
44
|
+
"@azeth/common": "^0.2.9",
|
|
45
|
+
"@azeth/sdk": "^0.2.9",
|
|
46
46
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
47
47
|
"dotenv": "^16.4.0",
|
|
48
48
|
"viem": "^2.21.0",
|