erickwendel-contributions-mcp

A Model Context Protocol (MCP) server that provides tools to query Erick Wendel's contributions across different platforms. Query talks, blog posts, and videos using natural language through Claude, Cursor or similars. This project was built using Cursor IDE with the default agent (trial version).

Quick Start

Use this MCP server directly with Claude Desktop or Cursor without installation:

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

Add this configuration to:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Cursor: ~/.cursor/mcp.json

Available Tools

This MCP server provides the following capabilities:

Tools

• get-talks: Retrieves a paginated list of talks with optional filtering

  • Supports filtering by ID, title, language, city, country, and year
  • Can return counts grouped by language, country, or city

• get-posts: Fetches posts with optional filtering and pagination

  • Supports filtering by ID, title, language, and portal

• get-videos: Retrieves videos with optional filtering and pagination

  • Supports filtering by ID, title, and language

• check-status: Verifies if the API is alive and responding

Prompts

• find-content: Generate queries to find specific content by type, topic, and language
• summarize-activity: Create summaries of content activity by year

Resources

• erickwendel://about: Server information and capabilities metadata
• erickwendel://statistics: Content statistics and available queries

Integration with AI Tools

Inspect MCP Server Capabilities

You can inspect this MCP server's capabilities using the MCP Inspector:

npm run inspect

This will show you all available tools, their parameters, and how to use them.

Setup

1. Make sure you're using Node.js v20+

node -v
# v20.x.x or higher

2. Clone this repository:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. Install dependencies:

npm ci

4. Run the server:

npm start

Integration with AI Tools

Cursor Setup

Add the following configuration to ~/.cursor/mcp.json:

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

Make sure Cursor chat is in Agent mode by selecting "Agent" in the lower left side dropdown, then ask "how many videos were published about JavaScript in 2024":

Local Development

For local development, use the absolute path to the project:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Claude Desktop Setup

1. Go to Claude settings
2. Click in the Developer tab
3. Click in edit config
4. Open the config in a code editor
5. Add the following configuration to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Local Development