MCP OGP TypeScript Server

A TypeScript implementation of the Open Graph Protocol (OGP) information extraction server for the Model Context Protocol (MCP).

Features

• Extract OGP metadata from web pages
• Retrieve and process OGP images
• Built with TypeScript for type safety
• Compatible with MCP clients like Claude Desktop

Installation

# Install via npm
npm install @yareyaredesuyo/mcp-server-ogp

# Or install via pnpm
pnpm add @yareyaredesuyo/mcp-server-ogp

Development Installation

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run in development mode
pnpm dev

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "ogp-typescript": {
      "command": "npx",
      "args": ["@yareyaredesuyo/mcp-server-ogp"]
    }
  }
}

Or if you have the package installed globally:

{
  "mcpServers": {
    "ogp-typescript": {
      "command": "mcp-server-ogp"
    }
  }
}

Available Tools

ogp_info

Extract OGP information from a URL.

Parameters:

• url (string): The URL to extract OGP information from

Returns:

• JSON object containing OGP metadata (title, description, image, etc.)

ogp_image

Retrieve the OGP image from a URL.

Parameters:

• url (string): The URL to extract the OGP image from

Returns:

• Base64 encoded image data or error message

Development

Scripts

• pnpm build - Build the TypeScript project
• pnpm dev - Run in development mode
• pnpm format - Format code with Biome
• pnpm lint - Lint code with Biome
• pnpm check - Run format and lint checks
• pnpm typecheck - Run TypeScript type checking

Code Quality

This project uses:

• TypeScript for type safety
• Biome for formatting and linting
• Zod for runtime schema validation

License

MIT