Metadata-Version: 2.4
Name: bezt-mcp
Version: 0.1.0
Summary: Bezt MCP – Best practices for every technology, right in your AI coding assistant.
Author: Bezt Team
License: MIT
License-File: LICENSE
Keywords: ai,best-practices,coding-assistant,mcp
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: platformdirs>=4.0.0
Description-Content-Type: text/markdown

# 🏆 Bezt MCP – Best Practices for Every Technology

**The free MCP that gives your AI coding assistant instant access to curated best practices for thousands of technologies.**

> Stop guessing. Start coding with proven patterns.

---

## ⚡ One-Click Install

### VS Code / GitHub Copilot

[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Bezt_MCP-007ACC?style=for-the-badge&logo=visual-studio-code)](vscode://mcp/install?url=https%3A%2F%2Fgithub.com%2Fbezt-team%2Fbezt-mcp)

Or add to your `.vscode/mcp.json`:
```json
{
  "servers": {
    "bezt": {
      "command": "uvx",
      "args": ["bezt-mcp"]
    }
  }
}
```

### Cursor

Add to your `~/.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "bezt": {
      "command": "uvx",
      "args": ["bezt-mcp"]
    }
  }
}
```

### Windsurf

Add to your `~/.windsurf/mcp.json`:
```json
{
  "mcpServers": {
    "bezt": {
      "command": "uvx",
      "args": ["bezt-mcp"]
    }
  }
}
```

### Claude Desktop

Add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "bezt": {
      "command": "uvx",
      "args": ["bezt-mcp"]
    }
  }
}
```

### Any MCP-compatible tool (CLI)

```bash
# Install with uv (recommended - fastest)
uvx bezt-mcp

# Or with pip
pip install bezt-mcp
bezt-mcp
```

---

## 🛠️ Tools

### `find-best-practices-id`
Search for best practices topics and get their bezt IDs.

| Parameter | Required | Description |
|-----------|----------|-------------|
| `topic` | ✅ | Your topic (e.g. `"FastAPI"`, `"SAAS cybersecurity"`, `"React hooks"`) |

**Returns:** Matching best practices topics with their bezt IDs.

### `fetch-best-practices`
Fetch the full best practices document.

| Parameter | Required | Description |
|-----------|----------|-------------|
| `topicId` | ✅ | Exact bezt ID from `find-best-practices-id` |

**Returns:** Full best practices formatted as Markdown.

---

## 🔒 Privacy

- **Open source**: Full source code is available for audit.
- **Anonymous by design**: No personal data is collected. A device-based anonymous ID is generated locally for anti-bot purposes.
- **Local caching**: Results are cached locally for 24h to minimize API calls and speed up repeated queries.

---

## 📊 Thousands of Technologies Covered

Python, JavaScript, TypeScript, React, FastAPI, Django, Node.js, Rust, Go, Java, C#, Swift, Kotlin, Flutter, Docker, Kubernetes, AWS, Azure, GCP, PostgreSQL, MongoDB, Redis, GraphQL, REST APIs, Security, Testing, CI/CD, and thousands more.

---

## 🔧 Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `BEZT_API_URL` | `https://bezt-backend-xyz.run.app` | Backend API URL |
| `BEZT_CACHE_TTL` | `86400` (24h) | Local cache TTL in seconds |

---

## 📄 License

MIT – Free for everyone, forever.
