bdjobs.mcp
by MONGSING
README.md
# BDjobs Profile Server
This project implements a small MCP-compatible server that fetches BDjobs profile data using Puppeteer and exposes a tool for retrieving the profile text.
## Project structure
- `src/` - TypeScript source code
- `dist/` - Compiled output (not committed)
- `package.json` - Node package configuration
- `tsconfig.json` - TypeScript compiler configuration
- `.gitignore` - Ignored files and folders for Git
## Prerequisites
- Node.js 18+ installed
- npm installed
## Setup
1. Open a terminal in the project folder:
```powershell
cd D:\WordPress_Ai\bdjobs
```
2. Install dependencies:
```powershell
npm install
```
## Build
Compile the TypeScript source into `dist/`:
```powershell
npm run build
```
## Run
Start the server from the compiled output:
```powershell
npm start
```
## Development
If you want to run TypeScript directly during development, install `ts-node` and use a direct execution command or run your own script.
## GitHub / Version Control
1. Initialize Git (if not already initialized):
```powershell
git init
```
2. Add files:
```powershell
git add .
```
3. Commit:
```powershell
git commit -m "Initial commit"
```
4. Add remote repository and push:
```powershell
git remote add origin https://github.com/your-username/your-repo.git
git branch -M main
git push -u origin main
```
## Security notes
- Do not commit `node_modules/` or `dist/`.
- Do not store secrets, cookies, API keys, or personal credentials in source files.
- Use `.env` or another secure secret management method if you need configuration values.
## How it works
The server exposes a tool named `fetch_complete_profile` and accepts two parameters:
- `userId` - the value of `MybdjobsUserId` cookie
- `logId` - the value of `MybdjobsLogId` cookie
It launches Puppeteer, injects the cookies, opens BDjobs, and returns the page text.
## Notes
- You may need to install additional Puppeteer dependencies depending on your OS.
- This project is intended for use with an MCP-compatible client.
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues