π¦
Credential Manager MCP
A FastMCP server for securely managing API credentials locally
0 installs
1 forks
Trust: 45 β Fair
Devtools
Installation
npx credential-manager-mcpAsk AI about Credential Manager MCP
Powered by Claude Β· Grounded in docs
I know everything about Credential Manager MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
π Credential Manager MCP Server
A secure MCP server for managing API credentials locally. Read-only by default with simple JSON storage.
β¨ Features
- π Secure by default - Read-only mode prevents accidental changes
- π Simple storage -
~/.credential-manager-mcp/credentials.json - π§ Easy setup - Interactive shell script
- π Multi-instance safe - Always reads fresh data from disk
- π― Minimal exposure - Shows only essential data
π Quick Start
1. Install & Configure
# Install from PyPI
uvx credential-manager-mcp
Common config (Claude Desktop):
{
"mcpServers": {
"credential-manager": {
"command": "uvx",
"args": ["credential-manager-mcp"],
"env": {
"CREDENTIAL_MANAGER_READ_ONLY": "false"
}
}
}
}
Devlopment config (run from source):
{
"mcpServers": {
"credential-manager": {
"command": "uv",
"args": [
"--directory", "/path/to/credential-manager-mcp",
"run", "credential-manager-mcp"
],
"env": {
"CREDENTIAL_MANAGER_READ_ONLY": "false"
}
}
}
}
2. Add Credentials
# Interactive mode
./add-credential.sh
# Command line
./add-credential.sh "GitHub" "https://api.github.com" "ghp_token" "username" "2024-12-31T23:59:59"
π Available Tools
Read-Only Mode (Default):
list_credentials()- List credentials (id, app name only)get_credential_details(credential_id)- Get full details
Read-Write Mode:
add_credential(app, base_url, access_token, [user_name], [expires])update_credential(credential_id, [fields...])delete_credential(credential_id)
π Usage Examples
# List all credentials
list_credentials()
# {"credentials": [{"id": "abc...", "app": "GitHub"}], "count": 1}
# Get credential details
get_credential_details("credential-id")
# Add new credential (write mode only)
add_credential("GitHub", "https://api.github.com", "ghp_token", "user", "2024-12-31T23:59:59")
βοΈ Configuration
Environment Variables:
CREDENTIAL_MANAGER_READ_ONLY- Set to"false"for write operations (default:"true")
Expiration Format:
"2024-12-31T23:59:59"- ISO datetime"never"- No expiration
π Security
- Read-only by default
- Local storage only (
~/.credential-manager-mcp/credentials.json) - File locking for safe concurrent access
- Minimal data exposure in listings
π§ͺ Development
git clone https://github.com/mclamee/credential-manager-mcp.git
cd credential-manager-mcp
uv sync --dev
uv run pytest test/ -v
π License
MIT License - see LICENSE file for details.
