uns-mcp-server/PUBLISH_INSTRUCTIONS.md

Pure JavaScript MCP server for Unstructured.io - No Python required!

# Publishing Instructions

## 📦 NPM Publishing (Requires OTP)

To publish to npm, you need to provide your 2FA one-time password:

```bash
cd "/Users/davidkennedy/Documents/Work Space/Ireland Investment Exit/uns-mcp-npx"
npm publish --access public --otp=YOUR_OTP_CODE
```

Replace `YOUR_OTP_CODE` with the 6-digit code from your authenticator app.

## 🐙 GitHub Repository Setup

### 1. Create the repository on GitHub:
Go to: https://github.com/organizations/CG-Labs/repositories/new

Use these settings:
- **Repository name**: Unstructured-Document-Processor-MCP
- **Description**: NPX-executable Unstructured.io MCP server for Claude Code and AI document processing
- **Public** repository
- **DO NOT** initialize with README (we already have one)

### 2. Push the code:
```bash
cd "/Users/davidkennedy/Documents/Work Space/Ireland Investment Exit/uns-mcp-npx"
git push -u origin main
```

If you get an authentication error, you may need to:
1. Create a Personal Access Token: https://github.com/settings/tokens
2. Use the token as your password when prompted

## ✅ After Publishing

### Verify npm package:
```bash
# Test npx installation
npx uns-mcp-server --help

# View on npmjs.com
open https://www.npmjs.com/package/uns-mcp-server
```

### Verify GitHub repository:
```bash
open https://github.com/CG-Labs/Unstructured-Document-Processor-MCP
```

## 🔐 Security Note

The API key has been removed from all files. Users will need to:
1. Get their own key from https://unstructured.io
2. Set it as environment variable or in their own .env file

## 📋 Quick Test

After publishing, test the complete flow:
```bash
# Clean test in a new directory
cd /tmp
npx uns-mcp-server --help
```

## 🎉 Success!

Once published, users can install globally or use via npx:
```bash
# Global install
npm install -g uns-mcp-server

# Or use directly with npx
npx uns-mcp-server

# Add to Claude Desktop
claude mcp add uns-mcp npx uns-mcp-server
```