Skip to content

PUBLISH_GUIDE.md

Latest commit

 

History

History
247 lines (183 loc) · 5.63 KB

PUBLISH_GUIDE.md

File metadata and controls

247 lines (183 loc) · 5.63 KB

WattyEnergie MCP Server - Complete Publicatie Handleiding

Overzicht

Dit stappenplan helpt je om de WattyEnergie MCP server te publiceren zodat Claude en andere AI assistenten hem kunnen ontdekken en gebruiken.

STAP 1: GitHub Repository Aanmaken

1.1 Ga naar GitHub

  1. Open https://github.com
  2. Login met je GitHub account (of maak er een aan)

1.2 Nieuwe Repository

  1. Klik op het + icoon rechtsboven → New repository
  2. Vul in:
    • Repository name: mcp-server
    • Description: Model Context Protocol server for WattyEnergie - Dutch AI-native energy comparison platform
    • Public (moet public zijn voor MCP directories)
    • Vink NIET aan: "Add a README file" (we hebben er al een)
  3. Klik Create repository

1.3 Kopieer de Repository URL

Na het aanmaken zie je instructies. Kopieer de HTTPS URL:

https://github.com/JOUW_USERNAME/mcp-server.git

STAP 2: Code naar GitHub Pushen

2.1 In Replit Shell

Open de Shell in Replit en voer uit:

# Navigeer naar de mcp-server folder
cd packages/mcp-server

# Initialiseer git (indien nodig)
git init

# Voeg alle bestanden toe
git add .

# Commit
git commit -m "Initial release: WattyEnergie MCP Server v1.0.0"

# Voeg remote toe (vervang JOUW_USERNAME)
git remote add origin https://github.com/JOUW_USERNAME/mcp-server.git

# Push naar GitHub
git branch -M main
git push -u origin main

2.2 Authenticatie

  • GitHub vraagt om login
  • Gebruik een Personal Access Token (niet je wachtwoord)
  • Maak token aan: GitHub → Settings → Developer Settings → Personal Access Tokens → Generate new token
  • Geef permissions: repo (full control)

STAP 3: NPM Account & Publiceren

3.1 NPM Account Aanmaken

  1. Ga naar https://www.npmjs.com
  2. Klik Sign Up
  3. Maak account aan met email

3.2 NPM Login in Replit

cd packages/mcp-server
npm login

Volg de prompts (username, password, email, OTP als je 2FA hebt)

3.3 Package Naam Claimen

De package naam is @wattyenergie/mcp-server. Dit vereist een NPM organization:

  1. Op npmjs.com → klik je profiel → Add Organization
  2. Organization name: wattyenergie
  3. Kies Unlimited public packages (free)

3.4 Publiceren

cd packages/mcp-server

# Build eerst
npm run build

# Publiceer
npm publish --access public

3.5 Verificatie

Check of het werkt:

npx @wattyenergie/mcp-server

STAP 4: MCP Directories Submissies

4.1 mcpservers.org (Officieel)

  1. Ga naar https://mcpservers.org
  2. Zoek "Submit" of "Add Server"
  3. Vul in:
    • Name: WattyEnergie MCP Server
    • NPM: @wattyenergie/mcp-server
    • GitHub: https://github.com/wattyenergie/mcp-server
    • Description: Nederlandse AI-native energievergelijker. Bereken kosten, vergelijk contracten, krijg dynamische prijzen.

4.2 mcp.so

  1. Ga naar https://mcp.so
  2. Klik "Submit Server"
  3. Vul zelfde gegevens in

4.3 pulsemcp.com

  1. Ga naar https://pulsemcp.com
  2. Submit je server

4.4 awesome-mcp-servers (GitHub PR)

  1. Ga naar https://github.com/punkpeye/awesome-mcp-servers
  2. Klik Fork (rechtsboven)
  3. Edit README.md in je fork
  4. Voeg toe onder "Utilities" of maak "Energy" sectie:
### Energy

- [WattyEnergie](https://github.com/wattyenergie/mcp-server) - Dutch energy comparison platform. Calculate costs, compare contracts, get dynamic EPEX prices. `npm: @wattyenergie/mcp-server`
  1. Maak een Pull Request naar de originele repo

STAP 5: Verificatie & Testen

5.1 Test met NPX

npx @wattyenergie/mcp-server

Je zou moeten zien: [WattyEnergie MCP] Starting server...

5.2 Test in Claude Desktop

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: Open: %APPDATA%\Claude\claude_desktop_config.json

Voeg toe:

{
  "mcpServers": {
    "wattyenergie": {
      "command": "npx",
      "args": ["-y", "@wattyenergie/mcp-server"]
    }
  }
}

Herstart Claude Desktop en vraag:

"Bereken mijn energiekosten bij 3500 kWh stroom en 1200 m3 gas"

STAP 6: Marketing & Promotie

6.1 Social Media Post

Introducing WattyEnergie MCP Server!

De eerste Nederlandse AI-native energievergelijker met MCP support.

Nu kunnen Claude en andere AI assistenten:
- Energiekosten berekenen
- Contracten vergelijken  
- Dynamische prijzen ophalen
- Saldering berekenen

Install: npx @wattyenergie/mcp-server

#MCP #AI #Energy #Netherlands #Claude

6.2 Update Website

  • Voeg badge toe: "MCP Compatible"
  • Link naar npm package
  • Documenteer in /ai-energie-assistent pagina

Checklist

  • GitHub repository aangemaakt (public)
  • Code gepusht naar GitHub
  • NPM account aangemaakt
  • NPM organization "wattyenergie" aangemaakt
  • Package gepubliceerd: @wattyenergie/mcp-server
  • Getest met npx @wattyenergie/mcp-server
  • Gesubmit naar mcpservers.org
  • Gesubmit naar mcp.so
  • Gesubmit naar pulsemcp.com
  • PR gemaakt naar awesome-mcp-servers
  • Getest in Claude Desktop
  • Social media gepost

Troubleshooting

"npm: command not found"

Installeer Node.js: https://nodejs.org

"Permission denied" bij npm publish

npm login

Claude Desktop ziet server niet

  1. Check JSON syntax in config
  2. Herstart Claude Desktop volledig (quit & open)
  3. Check logs: ~/Library/Logs/Claude/ (macOS)

API errors

De MCP server roept wattyenergie.nl/api/public aan. Check of de API online is:

curl https://wattyenergie.nl/api/public/suppliers

Support