# 🔐 API Manager MCP Server

An enhanced MCP (Model Context Protocol) server for securely managing API keys that works seamlessly with Claude Desktop and Claude Code.

## ✨ Features

### 🔒 Security First
- **Secure file permissions** (600) for environment files
- **Atomic file operations** to prevent corruption
- **Automatic backups** before deletions
- **Value masking** for safe display
- **Input validation** for all operations

### 📊 Smart Organization
- **Automatic categorization** of API keys based on service providers
- **Advanced search** across key names and categories
- **Statistics and analytics** for your API key usage
- **Export functionality** in multiple formats

### 🛠️ Enhanced Functionality
- **Comprehensive logging** for audit trails
- **Command-line interface** with flexible options
- **Error handling** with detailed feedback
- **Backup management** with timestamped backups

### 🎯 Supported Categories
- **AI/LLM Services**: Anthropic, OpenAI, Google AI, Groq, Mistral, DeepSeek, etc.
- **Database & Storage**: Supabase, Neo4j, Qdrant, Pinecone, Airtable, etc.
- **Communication**: Discord, Slack, Twilio, Telegram, etc.
- **Development Tools**: GitHub, Firebase, Vercel, Netlify, etc.
- **Cloud & Hosting**: AWS, Azure, GCP, Railway, Heroku, etc.
- **And many more...**

## 🚀 Quick Start

### Prerequisites
- Python 3.8 or higher
- Claude Desktop or Claude Code

### Installation

1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/API_Manager_MCPServer.git
cd API_Manager_MCPServer
```

2. **Install dependencies:**
```bash
pip install -r requirements.txt
```

3. **Configure for Claude Desktop:**

Add to your Claude Desktop configuration file (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "api-manager": {
      "command": "python",
      "args": ["/path/to/API_Manager_MCPServer/api_manager.py"],
      "env": {}
    }
  }
}
```

4. **Configure for Claude Code:**

Add to your Claude Code MCP settings:

```json
{
  "mcp": {
    "servers": {
      "api-manager": {
        "command": "python",
        "args": ["/path/to/API_Manager_MCPServer/api_manager.py"]
      }
    }
  }
}
```

### Basic Usage

Once configured, you can use the API Manager through Claude with natural language:

```
"List my API keys"
"Add a new OpenAI API key"
"Search for Discord keys"
"Show statistics about my API keys"
"Create a backup of my environment file"
```

## 📖 Detailed Usage

### Available Commands

#### 🔍 Query Commands

**`list_api_keys`** - List all API keys with categories
- `show_values`: Show actual values (default: false)
- `category`: Filter by specific category

**`get_api_key`** - Get a specific API key by name
- `key_name`: Name of the key to retrieve

**`search_api_keys`** - Search for API keys by name or category
- `query`: Search term
- `show_values`: Show actual values (default: false)

**`list_categories`** - List all categories with counts

#### 📝 Management Commands

**`add_api_key`** - Add or update an API key
- `key_name`: Name of the API key
- `value`: The API key value

**`delete_api_key`** - Delete an API key
- `key_name`: Name of the key to delete

#### 🛠️ Utility Commands

**`backup_env_file`** - Create timestamped backup

**`get_stats`** - Show detailed statistics

**`export_keys`** - Export keys in JSON or ENV format
- `format`: "json" or "env" (default: json)
- `include_values`: Include actual values (default: false)

**`help`** - Show comprehensive help

### Command Line Options

```bash
python api_manager.py --help
python api_manager.py --version
python api_manager.py --env-file /custom/path/.env
python api_manager.py --log-level DEBUG
```

### Environment File Location

By default, API keys are stored in:
- `~/.config/api_manager/.env`

You can specify a custom location using:
- Command line: `--env-file /path/to/.env`
- Environment variable: `API_MANAGER_ENV_FILE`

## 🔧 Configuration

### Environment File Format

```bash
# API Manager Environment File
# Created on 2024-01-01 12:00:00

# AI Services
ANTHROPIC_API_KEY=sk-ant-1234567890abcdef
OPENAI_API_KEY=sk-1234567890abcdef

# Database Services
SUPABASE_API_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9

# Communication
DISCORD_BOT_TOKEN=ODcyNzM0NjI5NjU2MjE3NjAw
```

### Security Best Practices

1. **File Permissions**: The environment file is automatically created with secure permissions (600)
2. **Backups**: Always create backups before making changes
3. **Value Masking**: Use `show_values=false` when listing keys
4. **Logging**: Monitor the log file for any suspicious activity
5. **Access Control**: Limit access to the environment file location

## 🧪 Testing

Run the test suite:

```bash
# Install test dependencies
pip install pytest pytest-asyncio pytest-cov

# Run tests
pytest tests/

# Run with coverage
pytest tests/ --cov=api_manager --cov-report=html
```

## 📊 Monitoring and Logs

The API Manager creates detailed logs in `api_manager.log`:

```bash
# View recent activity
tail -f api_manager.log

# Search for specific operations
grep "Tool called" api_manager.log
```

## 🔧 Development

### Project Structure

```
API_Manager_MCPServer/
├── api_manager.py          # Main MCP server
├── requirements.txt        # Dependencies
├── setup.py               # Package configuration
├── README.md              # This file
├── LICENSE                # License file
├── tests/                 # Test suite
│   ├── __init__.py
│   ├── test_api_manager.py
│   └── test_integration.py
├── docs/                  # Documentation
│   ├── configuration.md
│   ├── security.md
│   └── troubleshooting.md
└── examples/              # Usage examples
    ├── claude_desktop_config.json
    └── usage_examples.md
```

### Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

## 📜 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🤝 Support

- **Issues**: [GitHub Issues](https://github.com/yourusername/API_Manager_MCPServer/issues)
- **Discussions**: [GitHub Discussions](https://github.com/yourusername/API_Manager_MCPServer/discussions)
- **Documentation**: [Full Documentation](https://api-manager-mcp.readthedocs.io/)

## 🚧 Roadmap

- [ ] Web UI for API key management
- [ ] Integration with popular password managers
- [ ] Multi-environment support (dev, staging, prod)
- [ ] API key rotation notifications
- [ ] Advanced audit logging
- [ ] Team collaboration features

## 🙏 Acknowledgments

- Built on the [Model Context Protocol (MCP)](https://github.com/anthropics/mcp) by Anthropic
- Inspired by the need for secure API key management in AI workflows
- Community feedback and contributions

---

**⚠️ Security Notice**: API keys are sensitive credentials. Always follow security best practices and never commit API keys to version control systems.