README.mdโข2.35 kB
# MCP Resume Scorer with Leaderboard
Welcome to the MCPs repository! This project showcases custom MCP server implementations designed to provide AI models with secure, contextual access to tools and data. Whether you're building resume scoring endpoints, integrating OAuth, or experimenting with FastAPI and Gemini, this repo is your playground for creative, real-world AI utilities.
---
## ๐ Features
- โ
Resume scoring with AI-based feedback
- ๐ Google OAuth integration for secure access
- โก FastAPI endpoints with robust error handling
- ๐งช Swagger UI for easy testing and documentation
- ๐ ngrok tunneling for public access and webhook testing
---
## ๐ Project Structure
```
mcp-starter-main/
โโโ mcp-bearer-token/
โ โโโ app.py # Flask app with OAuth and token handling
โ โโโ credentials.json # Google OAuth secrets (not committed)
โ โโโ requirements.txt # Python dependencies
โ โโโ README.md # You're reading it!
```
---
## ๐ง Setup Instructions
### 1. Clone the repo
```bash
git clone https://github.com/Mokksh-bhatt/MCPs.git
cd MCPs/mcp-bearer-token
```
### 2. Create a virtual environment
```bash
python -m venv venv
.\venv\Scripts\activate # Windows
```
### 3. Install dependencies
```bash
pip install -r requirements.txt
```
### 4. Add your Google OAuth credentials
- Download `credentials.json` from [Google Cloud Console](https://console.cloud.google.com/)
- Place it in the project root
- If named differently, set the environment variable:
```powershell
$env:GOOGLE_CLIENT_SECRETS = "your_file_name.json"
```
### 5. Run the server
```bash
python app.py
```
---
## ๐ Expose Locally with ngrok
```bash
ngrok http 5000
```
Visit `http://127.0.0.1:4040` for the ngrok dashboard and copy your public URL.
---
## ๐ง Future Plans
- Add leaderboard scoring and resume feedback visualization
- Integrate Gemini fallback models
- Deploy to cloud platforms for persistent access
---
## ๐ค Contributing
Pull requests, ideas, and feedback are welcome! Feel free to fork and build your own MCP extensions.
---
## ๐ License
This project is open-source under the MIT License.
---
## โจ Author
Built with curiosity and creativity by [Mokksh Bhatt](https://github.com/Mokksh-bhatt)