https://github.com/mschuchard/vault-mcp-server
The third-party FOSS MCP server for Vault
https://github.com/mschuchard/vault-mcp-server
mcp mcp-server vault vault-plugin
Last synced: 2 months ago
JSON representation
The third-party FOSS MCP server for Vault
- Host: GitHub
- URL: https://github.com/mschuchard/vault-mcp-server
- Owner: mschuchard
- License: mit
- Created: 2025-04-10T18:49:17.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2026-04-13T21:27:51.000Z (3 months ago)
- Last Synced: 2026-04-13T23:27:53.977Z (3 months ago)
- Topics: mcp, mcp-server, vault, vault-plugin
- Language: Python
- Homepage:
- Size: 180 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **vault-mcp-server** - The third-party FOSS MCP server for Vault `python` `mcp` `mcp-server` `vault` `vault-plugin` `pip install git+https://github.com/mschuchard/vault-mcp-server` (🤖 AI/ML)
README
# Vault MCP Server
There is now an official Vault MCP Server from Hashicorp. Therefore, the alternative third-party Vault MCP Server will continue to exist and be updated with features and fixes, but no attempt will be made to compete with the official product. The third-party Vault MCP Server can be executed locally instead of only remotely (although in many situations remote is preferable), and will continue to be available as a container image.
Due to this policy enacted because of the official product release, there will be no formal release process, versioning, or changelog. This product is also not recommended for enterprise production usage.
The MCP Server container image is hosted at [Dockerhub](https://hub.docker.com/r/matthewschuchard/vault-mcp-server), and it represents the code hosted here at `HEAD`.
## Desktop Configs
These can hopefully be extrapolated and modified to fit other clients if you want to play with this server for whatever reason.
**Claude**
```json
{
"mcpServers": {
"vault": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VAULT_URL",
"-e",
"VAULT_TOKEN",
"-e",
"CACHE_TTL",
"matthewschuchard/vault-mcp-server"
],
"env": {
"VAULT_URL": "",
"VAULT_TOKEN": "",
"CACHE_TTL": ""
}
}
}
}
```
**VSCode**
The `MCP: Add Server --> Docker Image` command can also streamline this configuration. The values below can be entered into the input prompts, and then the `mcp.json` file is automically opened within a pane afterward for further updates if necessary.
```json
{
"servers": {
"vault": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VAULT_URL",
"-e",
"VAULT_TOKEN",
"-e",
"CACHE_TTL",
"matthewschuchard/vault-mcp-server"
],
"env": {
"VAULT_URL": "",
"VAULT_TOKEN": "",
"CACHE_TTL": ""
}
}
}
}
```
Note that `CACHE_TTL` is an optional environment variable that establishes the cache time for all read and list operations before new value(s) are retrieved instead of using the cached value. The default value is sixty (60) seconds.
## Features
### Resources
- Current Enabled ACL Policies
- Current Enabled Audit Devices
- Current Enabled Authentication Engines
- Current Enabled Secret Engines
- Current Raft Cluster Configuration
### Tools
- System Backend
- ACL Policies
- Audit Devices
- Authentication Engines
- Raft (Clustering and Storage Snapshots)
- Secrets Engines
- Secrets Backend
- Database (Beta)
- KV Version 2
- PKI
- Transit
### Prompts
- mcp.vault.example-acl-policy: This displays an example Vault ACL Policy in JSON string format. The displayed policy can be modified and entered as-is to the LLM (verified with Claude), and it will understand that you want to create an ACL Policy through the Vault MCP Server with your modified content (with an auto-generated name). However, it is probably more prudent to use it as an input to the tool instead.
- mcp.vault.generate-acl-policy: This displays a pseudo-example Vault ACL Policy in JSON string format similar to the above prompt. The primary difference is that this prompt accepts a `paths` argument in `list[str]` type format, and the returned policy will contain the input paths. However, the `capabilities` will still be boilerplate, and need to be modified for your usage.
- mcp.vault.generate-smart-acl-policy: This is an experimental interactive workflow with an agentic LLM to create and optimize a Vault ACL policy based on user requirements and prompts. It will also return the policy in JSON string format.