# 🔌 linkedin-mcp-server

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg?style=flat-square)]()
[![Model Context Protocol](https://img.shields.io/badge/MCP-Standard-blue.svg?style=flat-square)](https://modelcontextprotocol.io)

> Enterprise Model Context Protocol (MCP) Server for LinkedIn Developer Profile Optimization, High-Engagement AI Post Generation, and Growth Strategy. Available in TypeScript and Python!

---

## 🎯 Features

- 🔍 **`analyze_linkedin_profile`**: Scores developer profile (0 to 100), detects missing social proof metrics, and outputs recommended headline/about hooks.
- ✍️ **`generate_linkedin_post`**: Generates type-safe technical posts, release announcements, and milestone posts optimized for the LinkedIn algorithm.
- 🐍🟦 **Dual Language Engine:** Native TypeScript Stdio MCP Server + Async Python FastAPI Server (`py/linkedin_mcp.py`).

---

## 📦 Installation & Setup

### 1. Build TypeScript Server

```bash
git clone https://github.com/isaquefl/linkedin-mcp-server.git
cd linkedin-mcp-server
npm install
npm run build
```

### 2. Configure in Claude Desktop / Antigravity IDE

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/absolute/path/to/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_PROFILE_URL": "https://linkedin.com/in/isaquefl"
      }
    }
  }
}
```

### 3. Run Python FastAPI Server (Optional)

```bash
cd py
pip install fastapi uvicorn pydantic
python linkedin_mcp.py
```

Swagger UI available at: `http://localhost:8000/docs`

---

## 🎮 Roblox & Custom MCP Server Extensions

Looking to connect AI to Roblox or custom platforms? This repository forms part of the **MCP Custom Server Framework** architecture (Project 7 in the 90-day plan). Stay tuned for `roblox-mcp-server` integration via OpenCloud API!

---

## 📄 License

MIT © [Isaque](https://github.com/isaquefl)