@aauth/mcp-stdio 0.1.1 → 0.1.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 +83 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# @aauth/mcp-stdio
|
|
2
|
+
|
|
3
|
+
Stdio-to-HTTP proxy for MCP with AAuth signatures. Bridges a local stdio MCP client (like Claude Code) to a remote HTTP MCP server, signing all requests with AAuth.
|
|
4
|
+
|
|
5
|
+
See the [AAuth repo](https://github.com/hellocoop/AAuth) for protocol overview.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @aauth/mcp-stdio
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## CLI
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npx @aauth/mcp-stdio --server https://api.example.com/mcp --agent https://user.github.io
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### Options
|
|
20
|
+
|
|
21
|
+
| Flag | Env var | Description |
|
|
22
|
+
|------|---------|-------------|
|
|
23
|
+
| `--server`, `-s` | `AAUTH_MCP_SERVER` | Remote MCP server URL (required) |
|
|
24
|
+
| `--agent`, `-a` | `AAUTH_AGENT_URL` | Agent identity URL (required) |
|
|
25
|
+
| `--delegate`, `-d` | `AAUTH_DELEGATE` | Delegate name (default: `claude`) |
|
|
26
|
+
| `--token-lifetime` | `AAUTH_TOKEN_LIFETIME` | Agent token lifetime in seconds (default: `3600`) |
|
|
27
|
+
|
|
28
|
+
### Claude Code Configuration
|
|
29
|
+
|
|
30
|
+
Add to your MCP server config:
|
|
31
|
+
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"mcpServers": {
|
|
35
|
+
"my-server": {
|
|
36
|
+
"command": "npx",
|
|
37
|
+
"args": ["@aauth/mcp-stdio", "--server", "https://api.example.com/mcp", "--agent", "https://user.github.io"]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Or with environment variables:
|
|
44
|
+
|
|
45
|
+
```json
|
|
46
|
+
{
|
|
47
|
+
"mcpServers": {
|
|
48
|
+
"my-server": {
|
|
49
|
+
"command": "npx",
|
|
50
|
+
"args": ["@aauth/mcp-stdio"],
|
|
51
|
+
"env": {
|
|
52
|
+
"AAUTH_MCP_SERVER": "https://api.example.com/mcp",
|
|
53
|
+
"AAUTH_AGENT_URL": "https://user.github.io"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## API
|
|
61
|
+
|
|
62
|
+
### `bridgeTransports(local, remote): Promise<void>`
|
|
63
|
+
|
|
64
|
+
Bridges two MCP transports for bidirectional message forwarding.
|
|
65
|
+
|
|
66
|
+
```ts
|
|
67
|
+
import { bridgeTransports } from '@aauth/mcp-stdio'
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### `parseArgs(argv): StdioArgs`
|
|
71
|
+
|
|
72
|
+
Parses CLI arguments with env var fallbacks.
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
import { parseArgs } from '@aauth/mcp-stdio'
|
|
76
|
+
|
|
77
|
+
const args = parseArgs(process.argv.slice(2))
|
|
78
|
+
// { serverUrl, agentUrl, delegate?, tokenLifetime? }
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## License
|
|
82
|
+
|
|
83
|
+
MIT
|