Local Developement of the MCP Server

Step 1: Install All Dependencies

# Install runtime dependencies
npm install @modelcontextprotocol/sdk axios cheerio puppeteer

# Install dev dependencies
npm install -D typescript @types/node

Step 2: Create package.json (if it doesnt exist yet)

bashcat > package.json << 'EOF'
{
  "name": "advanced-websearch-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "bin": {
    "advanced-websearch-mcp": "index.js"
  },
  "scripts": {
    "build": "tsc",
    "start": "node index.js",
    "dev": "tsx index.ts"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.4",
    "axios": "^1.7.0",
    "cheerio": "^1.0.0",
    "puppeteer": "^23.0.0"
  },
  "devDependencies": {
    "@types/node": "^22.0.0",
    "typescript": "^5.6.0",
    "tsx": "^4.19.0"
  }
}
EOF

Step 3: Install Dependencies

npm install

Step 4: Create tsconfig.json (if it doesnt exist yet)

cat > tsconfig.json << 'EOF'
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "./dist",
    "rootDir": ".",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "allowSyntheticDefaultImports": true
  },
  "include": ["index.ts"],
  "exclude": ["node_modules", "dist"]
}
EOF

Step 5: Compile

# Or compile to current folder
npx tsc --outDir .

Step 6: Run with Inspector

# Run the compiled JavaScript
npx @modelcontextprotocol/inspector node index.js

• Then click "connect" in the Browser UI.
• Then click "List Tools" to see the available tools
• Then click "fetch_and_ground" for the primary endpoint
• Then click "Add Item", enter a URL you want to test and click "Run Tool"

Publishing the npm package of the mcp server to use it with mcpo

Make sure you’re logged in:

npm login

npm publish

• then add the npm package to mcpo here: config.json
• pushing or tagging in the mcpo repository will create a new docker image
• then make the mcpo kubernetes pod use the newest docker image