envibe-mcp 0.1.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.
- package/README.md +81 -0
- package/dist/index.js +21500 -0
- package/package.json +38 -0
package/README.md
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# envibe-mcp
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/envibe-mcp)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
**MCP server for envibe** - the missing permission layer between AI agents and your .env.
|
|
7
|
+
|
|
8
|
+
## Install
|
|
9
|
+
|
|
10
|
+
Add to your AI tool's MCP config:
|
|
11
|
+
|
|
12
|
+
```json
|
|
13
|
+
{
|
|
14
|
+
"mcpServers": {
|
|
15
|
+
"envibe": {
|
|
16
|
+
"command": "npx",
|
|
17
|
+
"args": ["envibe-mcp"]
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
<details>
|
|
24
|
+
<summary><b>Claude Code</b></summary>
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
claude mcp add envibe npx envibe-mcp
|
|
28
|
+
```
|
|
29
|
+
</details>
|
|
30
|
+
|
|
31
|
+
<details>
|
|
32
|
+
<summary><b>Claude Desktop</b></summary>
|
|
33
|
+
|
|
34
|
+
Add to `claude_desktop_config.json`:
|
|
35
|
+
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
36
|
+
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
37
|
+
</details>
|
|
38
|
+
|
|
39
|
+
<details>
|
|
40
|
+
<summary><b>VS Code / Cursor / Windsurf</b></summary>
|
|
41
|
+
|
|
42
|
+
Add to your editor's MCP settings (see main [envibe](https://github.com/dominic-righthere/envibe) docs for details).
|
|
43
|
+
</details>
|
|
44
|
+
|
|
45
|
+
On first run, envibe automatically:
|
|
46
|
+
1. Creates `.env.manifest.yaml` from your `.env.example`
|
|
47
|
+
2. Generates `.env.ai` (filtered view for AI)
|
|
48
|
+
3. Blocks direct `.env` file access
|
|
49
|
+
|
|
50
|
+
## What is this?
|
|
51
|
+
|
|
52
|
+
This is the MCP server component of [envibe](https://github.com/dominic-righthere/envibe). It gives AI coding assistants controlled access to your environment variables with 5 access levels:
|
|
53
|
+
|
|
54
|
+
| Level | AI Can See | AI Can Modify |
|
|
55
|
+
|-------|-----------|---------------|
|
|
56
|
+
| `full` | Actual value | Yes |
|
|
57
|
+
| `read-only` | Actual value | No |
|
|
58
|
+
| `placeholder` | `<VAR_NAME>` | No |
|
|
59
|
+
| `schema-only` | Format only | No |
|
|
60
|
+
| `hidden` | Nothing | No |
|
|
61
|
+
|
|
62
|
+
## MCP Tools
|
|
63
|
+
|
|
64
|
+
| Tool | Description |
|
|
65
|
+
|------|-------------|
|
|
66
|
+
| `env_list` | List visible variables with access levels |
|
|
67
|
+
| `env_get` | Get a variable's value (respects permissions) |
|
|
68
|
+
| `env_set` | Set a variable (only `full` access) |
|
|
69
|
+
| `env_describe` | Get detailed info about a variable |
|
|
70
|
+
|
|
71
|
+
## For CLI tools
|
|
72
|
+
|
|
73
|
+
If you need CLI commands like `envibe setup -i` (interactive mode), `envibe view`, or `envibe generate`, install the full package:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
npm install -g envibe
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
## License
|
|
80
|
+
|
|
81
|
+
MIT
|