@ldraney/mcp-linkedin 0.1.2 → 0.2.1

package/.claude/settings.local.json

@@ -3,7 +3,8 @@
     "allow": [
       "WebSearch",
       "Bash(npm test:*)",
-      "Bash(git push)"
+      "Bash(git push)",
+      "Bash(gh issue close:*)"
     ]
   },
   "enableAllProjectMcpServers": true,

package/.mcpbignore

@@ -0,0 +1,33 @@
+# Development/test files
+__tests__/
+*.test.js
+jest.config.js
+.env
+.env.example
+
+# Documentation
+*.md
+!README.md
+
+# Git
+.git/
+.gitignore
+
+# IDE
+.vscode/
+.idea/
+
+# Claude dev files
+.claude/
+
+# OAuth relay (separate deployment)
+oauth-relay/
+
+# Old database files
+*.db
+scheduled_posts.db
+
+# Other
+test_post.js
+todos.db
+*.html

package/README.md

@@ -1,135 +1,115 @@
 # mcp-linkedin
 
-MCP server for managing LinkedIn posts - create, update, and manage posts to share expertise and GitHub projects.
+MCP server for managing LinkedIn posts - create text, image, video, document, poll, and multi-image posts. Schedule posts, add comments and reactions.
 
-## Overview
+## Installation
 
-This MCP (Model Context Protocol) server enables programmatic management of LinkedIn posts. The primary use case is to help share technical expertise, showcase GitHub projects, and engage with a professional audience through LinkedIn's platform.
+### MCPB Bundle (One-Click)
+Download from [latest release](https://github.com/intelligent-staffing-systems/mcp-linkedin/releases/latest) and open `mcp-linkedin.mcpb` with Claude Desktop.
 
-## User Story
-
-As a technical professional, I want to:
-- Create LinkedIn posts that link to my GitHub projects
-- Update existing posts to reflect project changes
-- Manage my LinkedIn content programmatically
-- Share my expertise and educational content with my professional network
-
-This tool is designed to help educate and demonstrate expertise to a LinkedIn audience through consistent, high-quality content sharing.
-
-## Status
-
-✅ **MVP Complete** - All core tools implemented and tested!
-
-**Milestones:**
-- ✅ LinkedIn Developer App with OAuth 2.0
-- ✅ 7 MCP tools implemented (create, get, delete posts + auth)
-- ✅ 24 automated tests passing
-- ✅ Type-safe with JSDoc + Zod validation
-- ✅ MCP server with stdio transport
-- ✅ Ready for Claude Desktop integration
-
-## Features
-
-### ✅ Implemented (MVP)
-
-- **linkedin_create_post** - Create simple text posts with hashtags and mentions
-- **linkedin_create_post_with_link** - Create posts with link previews (GitHub, blogs, etc.)
-- **linkedin_get_my_posts** - Retrieve your recent posts with pagination
-- **linkedin_delete_post** - Delete posts by URN
-- **linkedin_get_auth_url** - Generate OAuth authorization URL
-- **linkedin_exchange_code** - Exchange auth code for access token
-- **linkedin_get_user_info** - Get your LinkedIn profile information
-
-### 🚧 Planned (Next Phase)
-
-- **Post scheduling** - Schedule posts for future publication (HIGH PRIORITY)
-- **Draft management** - Save and manage draft posts locally
-- **Image uploads** - Create posts with images
-- **Post updates** - Edit existing posts
-- **Analytics** - View post engagement metrics (if API supports)
-
-## LinkedIn API
-
-This MCP will utilize LinkedIn's REST API:
-- Base URL: `https://api.linkedin.com/rest/posts`
-- Authentication: OAuth 2.0
-- Required permissions: `w_member_social` scope
-- API Documentation: [LinkedIn Posts API](https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api)
-
-## Development Philosophy
-
-1. Start with clear user stories based on LinkedIn API capabilities
-2. Refine requirements through discussion and iteration
-3. Build incrementally with well-defined issues and branches
-4. Test thoroughly with real-world use cases
-
-## Getting Started
-
-### Prerequisites
-
-1. Create a LinkedIn Developer App at https://www.linkedin.com/developers/apps
-2. Add these products to your app:
-   - "Sign In with LinkedIn using OpenID Connect"
-   - "Share on LinkedIn"
-3. Configure OAuth redirect URI (e.g., `https://localhost:3000/callback`)
-
-### Setup
-
-1. Clone the repository:
+### npm / npx
 ```bash
-git clone https://github.com/intelligent-staffing-systems/mcp-linkedin.git
-cd mcp-linkedin
+npx @ldraney/mcp-linkedin
 ```
 
-2. Install dependencies:
-```bash
-npm install
+### Manual MCP Config
+```json
+{
+  "mcpServers": {
+    "linkedin": {
+      "command": "npx",
+      "args": ["@ldraney/mcp-linkedin"],
+      "env": {
+        "LINKEDIN_CLIENT_ID": "your-client-id",
+        "LINKEDIN_CLIENT_SECRET": "your-client-secret",
+        "LINKEDIN_REDIRECT_URI": "https://localhost:8888/callback",
+        "LINKEDIN_PERSON_ID": "your-person-id",
+        "LINKEDIN_ACCESS_TOKEN": "your-access-token"
+      }
+    }
+  }
+}
 ```
 
-3. Create `.env` file (copy from `.env.example` and fill in your values):
-```bash
-cp .env.example .env
-```
+## Tools (20 Total)
+
+### Content Creation
+| Tool | Description |
+|------|-------------|
+| `linkedin_create_post` | Create text posts |
+| `linkedin_create_post_with_link` | Posts with article/link preview |
+| `linkedin_create_post_with_image` | Upload image + create post |
+| `linkedin_create_post_with_video` | Upload video + create post |
+| `linkedin_create_post_with_document` | Upload PDF/PPT/DOC + create post |
+| `linkedin_create_post_with_multi_images` | Upload 2-20 images + create post |
+| `linkedin_create_poll` | Create poll posts (2-4 options) |
+
+### Content Management
+| Tool | Description |
+|------|-------------|
+| `linkedin_get_my_posts` | Retrieve recent posts (paginated) |
+| `linkedin_update_post` | Edit existing posts |
+| `linkedin_delete_post` | Delete by URN |
+
+### Social Interactions
+| Tool | Description |
+|------|-------------|
+| `linkedin_add_comment` | Add comment to a post |
+| `linkedin_add_reaction` | React to a post (LIKE, PRAISE, etc.) |
+
+### Scheduling
+| Tool | Description |
+|------|-------------|
+| `linkedin_schedule_post` | Schedule for future publication |
+| `linkedin_list_scheduled_posts` | List by status |
+| `linkedin_cancel_scheduled_post` | Cancel pending post |
+| `linkedin_get_scheduled_post` | Get scheduled post details |
+
+### Authentication
+| Tool | Description |
+|------|-------------|
+| `linkedin_get_auth_url` | Start OAuth flow |
+| `linkedin_exchange_code` | Complete OAuth |
+| `linkedin_refresh_token` | Refresh expired token |
+| `linkedin_get_user_info` | Get profile info |
+
+## Setup
+
+### Option 1: Quick Setup (Recommended)
+1. Install the extension
+2. Ask Claude: "Help me set up LinkedIn authentication"
+3. Follow the guided OAuth flow
+
+### Option 2: Manual Setup
+1. Create a LinkedIn Developer App at https://www.linkedin.com/developers/apps
+2. Add products: "Sign In with LinkedIn using OpenID Connect" + "Share on LinkedIn"
+3. Configure redirect URI: `https://localhost:8888/callback`
+4. Set environment variables (see Installation above)
 
-4. Run tests:
+## Running the Scheduler
+
+For scheduled posts to publish automatically:
 ```bash
-npm test  # All 24 tests should pass
+npm run scheduler
 ```
 
-5. **Setup with Claude Desktop:**
-
-See [MCP_SETUP.md](./MCP_SETUP.md) for detailed Claude Desktop configuration instructions.
+This runs a daemon that checks every minute for posts due to publish.
 
-### Environment Variables
-
-See `.env.example` for required configuration:
-- `LINKEDIN_CLIENT_ID` - Your app's client ID
-- `LINKEDIN_CLIENT_SECRET` - Your app's client secret
-- `LINKEDIN_REDIRECT_URI` - OAuth callback URL
-- `LINKEDIN_PERSON_ID` - Your LinkedIn person URN (from userinfo endpoint)
-- `LINKEDIN_ACCESS_TOKEN` - OAuth access token (60-day expiry)
-
-## Documentation
-
-- **[MCP_SETUP.md](./MCP_SETUP.md)** - Claude Desktop configuration and usage guide
-- **[USER_STORY.md](./USER_STORY.md)** - Complete user stories and feature roadmap
-- **[LINKEDIN_API_REFERENCE.md](./LINKEDIN_API_REFERENCE.md)** - Comprehensive API documentation
-- **[src/types.js](./src/types.js)** - JSDoc type definitions
-- **[src/schemas.js](./src/schemas.js)** - Zod validation schemas
-
-## Testing
+## Development
 
 ```bash
-npm test              # Run all tests
-npm run test:watch    # Watch mode
+npm install
+npm test              # 118 tests
 npm run test:coverage # Coverage report
+npm start             # Start MCP server
+npm run scheduler     # Start scheduler daemon
 ```
 
-All 24 tests passing with 100% code coverage for core tools!
-
-## Contributing
+## Documentation
 
-Lucas Draney (@ldraney)
+- [CLAUDE.md](./CLAUDE.md) - Project structure and API details
+- [MCP_SETUP.md](./MCP_SETUP.md) - Claude Desktop configuration
+- [LINKEDIN_API_REFERENCE.md](./LINKEDIN_API_REFERENCE.md) - API documentation
 
 ## License
 

package/manifest.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": "0.2",
   "name": "@ldraney/mcp-linkedin",
-  "version": "0.1.2",
-  "description": "MCP server for managing LinkedIn posts - create text, image, video, document, poll, and multi-image posts. Schedule posts, add comments and reactions.",
+  "version": "0.2.1",
+  "description": "MCP server for LinkedIn - create posts, images, videos, documents, polls. One-click OAuth via built-in relay.",
   "author": {
     "name": "Lucas Draney"
   },
@@ -19,43 +19,22 @@
         "${__dirname}/src/index.js"
       ],
       "env": {
-        "LINKEDIN_CLIENT_ID": "${user_config.linkedin_client_id}",
-        "LINKEDIN_CLIENT_SECRET": "${user_config.linkedin_client_secret}",
-        "LINKEDIN_REDIRECT_URI": "${user_config.linkedin_redirect_uri}",
         "LINKEDIN_PERSON_ID": "${user_config.linkedin_person_id}",
         "LINKEDIN_ACCESS_TOKEN": "${user_config.linkedin_access_token}"
       }
     }
   },
   "user_config": {
-    "linkedin_client_id": {
-      "type": "string",
-      "title": "Client ID (optional)",
-      "description": "LinkedIn OAuth app client ID - leave blank to set up via chat",
-      "required": false
-    },
-    "linkedin_client_secret": {
-      "type": "string",
-      "title": "Client Secret (optional)",
-      "description": "LinkedIn OAuth app client secret - leave blank to set up via chat",
-      "required": false
-    },
-    "linkedin_redirect_uri": {
-      "type": "string",
-      "title": "Redirect URI (optional)",
-      "description": "OAuth callback URL - defaults to https://localhost:8888/callback",
-      "required": false
-    },
     "linkedin_person_id": {
       "type": "string",
       "title": "Person ID (optional)",
-      "description": "Your LinkedIn person ID - obtained automatically during OAuth",
+      "description": "Your LinkedIn person ID - obtained via OAuth flow in chat",
       "required": false
     },
     "linkedin_access_token": {
       "type": "string",
       "title": "Access Token (optional)",
-      "description": "OAuth access token - obtained via linkedin_exchange_code tool",
+      "description": "OAuth access token - obtained via OAuth flow in chat",
       "required": false
     }
   },

package/oauth-relay/Dockerfile

@@ -0,0 +1,12 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm install --production
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["node", "index.js"]

package/oauth-relay/fly.toml

@@ -0,0 +1,17 @@
+app = 'iss-linkedin-oauth'
+primary_region = 'sjc'
+
+[build]
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = 'stop'
+  auto_start_machines = true
+  min_machines_running = 0
+  processes = ['app']
+
+[[vm]]
+  memory = '256mb'
+  cpu_kind = 'shared'
+  cpus = 1

package/oauth-relay/index.js

@@ -0,0 +1,151 @@
+const express = require('express');
+const https = require('https');
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+const CLIENT_ID = process.env.LINKEDIN_CLIENT_ID;
+const CLIENT_SECRET = process.env.LINKEDIN_CLIENT_SECRET;
+const REDIRECT_URI = process.env.REDIRECT_URI || `https://${process.env.FLY_APP_NAME}.fly.dev/auth/callback`;
+const LOCALHOST_CALLBACK = 'http://localhost:8888/callback';
+
+// Health check
+app.get('/', (req, res) => {
+  res.json({ status: 'ok', service: 'mcp-linkedin-oauth-relay' });
+});
+
+// Step 1: Redirect user to LinkedIn OAuth
+app.get('/auth/linkedin', (req, res) => {
+  if (!CLIENT_ID) {
+    return res.status(500).json({ error: 'LINKEDIN_CLIENT_ID not configured' });
+  }
+
+  const scope = 'openid profile w_member_social';
+  const state = Math.random().toString(36).substring(7);
+
+  const authUrl = new URL('https://www.linkedin.com/oauth/v2/authorization');
+  authUrl.searchParams.set('response_type', 'code');
+  authUrl.searchParams.set('client_id', CLIENT_ID);
+  authUrl.searchParams.set('redirect_uri', REDIRECT_URI);
+  authUrl.searchParams.set('scope', scope);
+  authUrl.searchParams.set('state', state);
+
+  res.redirect(authUrl.toString());
+});
+
+// Step 2: Handle callback from LinkedIn, exchange code for token
+app.get('/auth/callback', async (req, res) => {
+  const { code, error, error_description } = req.query;
+
+  if (error) {
+    return redirectToLocalhost(res, { error, error_description });
+  }
+
+  if (!code) {
+    return redirectToLocalhost(res, { error: 'missing_code', error_description: 'No authorization code received' });
+  }
+
+  try {
+    // Exchange code for access token
+    const tokenData = await exchangeCodeForToken(code);
+
+    // Get user info to get person ID
+    const userInfo = await getUserInfo(tokenData.access_token);
+
+    // Redirect to localhost with token and person ID
+    redirectToLocalhost(res, {
+      access_token: tokenData.access_token,
+      expires_in: tokenData.expires_in,
+      person_id: userInfo.sub,
+      name: userInfo.name
+    });
+  } catch (err) {
+    console.error('OAuth error:', err);
+    redirectToLocalhost(res, { error: 'token_exchange_failed', error_description: err.message });
+  }
+});
+
+function redirectToLocalhost(res, params) {
+  const url = new URL(LOCALHOST_CALLBACK);
+  Object.entries(params).forEach(([key, value]) => {
+    if (value) url.searchParams.set(key, value);
+  });
+  res.redirect(url.toString());
+}
+
+function exchangeCodeForToken(code) {
+  return new Promise((resolve, reject) => {
+    const postData = new URLSearchParams({
+      grant_type: 'authorization_code',
+      code,
+      client_id: CLIENT_ID,
+      client_secret: CLIENT_SECRET,
+      redirect_uri: REDIRECT_URI
+    }).toString();
+
+    const options = {
+      hostname: 'www.linkedin.com',
+      path: '/oauth/v2/accessToken',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded',
+        'Content-Length': Buffer.byteLength(postData)
+      }
+    };
+
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          const parsed = JSON.parse(data);
+          if (parsed.error) {
+            reject(new Error(parsed.error_description || parsed.error));
+          } else {
+            resolve(parsed);
+          }
+        } catch (e) {
+          reject(new Error('Failed to parse token response'));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.write(postData);
+    req.end();
+  });
+}
+
+function getUserInfo(accessToken) {
+  return new Promise((resolve, reject) => {
+    const options = {
+      hostname: 'api.linkedin.com',
+      path: '/v2/userinfo',
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${accessToken}`
+      }
+    };
+
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch (e) {
+          reject(new Error('Failed to parse user info'));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.end();
+  });
+}
+
+app.listen(PORT, () => {
+  console.log(`OAuth relay running on port ${PORT}`);
+  console.log(`Auth URL: /auth/linkedin`);
+  console.log(`Callback: ${REDIRECT_URI}`);
+});