# erickwendel-contributions-mcp

> MCP Server

This repository hosts a Model Context Protocol (MCP) server designed to query Erick Wendel's contributions, including talks, blog posts, and videos, using natural language. It offers tools for filtering and

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 323
- **Forks:** 10
- **Owner:** ErickWendel
- **GitHub:** https://github.com/ErickWendel/erickwendel-contributions-mcp
- **Homepage:** https://smithery.ai/server/@ErickWendel/erickwendel-contributions-mcp
- **Created:** 2025-03-14T15:05:49+00:00
- **Updated:** 2025-03-28T22:14:19+00:00
- **Source:** https://model-context-protocol.com/servers/query-erick-wendel-contributions-across-platforms

## Setup

## Setup

1.  Make sure you're using Node.js v23+
```bash
node -v
#v23.9.0
```

2.  Clone this repository:
```bash
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
```

3.  Restore dependencies:
```bash
npm ci
```

### Cursor Setup

1.  Open Cursor Settings
2.  Navigate to MCP section
3.  Click "Add new MCP server"
4.  Configure the server:
   ```
   Name = erickwendel-contributions
   Type = command
   Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
   ```

   or if you prefer executing it from Smithery
   ```
   Name = erickwendel-contributions
   Type = command
   Command = npm exec -- @smithery/cli@latest run @ErickWendel/erickwendel-contributions-mcp
   ```

or configure directly from the Cursor's global MCP file located in `~/.cursor/mcp.json` and add the following:

```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}
```
or if you prefer executing it from Smithery
```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [
        "exec",
        "--",
        "@smithery/cli@latest",
        "run",
        "@ErickWendel/erickwendel-contributions-mcp"
      ]
    }
  }
}
```

5.  Make sure Cursor chat is in Agent mode by selecting "Agent" in the lower left side dropdown

6.  Go to the chat an ask "how many videos were published about JavaScript in 2024"

### Claude Desktop Setup

#### Installing via Smithery

To install Erick Wendel Contributions for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ErickWendel/erickwendel-contributions-mcp):

```bash
npx -y @smithery/cli install @ErickWendel/erickwendel-contributions-mcp --client claude
```

#### Manual 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 your Claude Desktop config:

```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}
```
or if you prefer executing it from Smithery
```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [
        "exec",
        "--",
        "@smithery/cli@latest",
        "run",
        "@ErickWendel/erickwendel-contributions-mcp"
      ]
    }
  }
}
```

6.  Save file and Restart Claude Desktop
7.  Open the Developer tab again and check if it's in the "running" state as follows:

### Free Alternative Using MCPHost

If you don't have access to Claude Desktop nor Cursor, you can use [MCPHost](https://github.com/mark3labs/mcphost) with Ollama as a free alternative.

1.  Install MCPHost:
```bash
go install github.com/mark3labs/mcphost@latest
```

2.  Create a config file (e.g. [./mcp.jsonc](./mcp.jsonc)):
```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}
```
or if you prefer executing it from Smithery
```json
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [
        "exec",
        "--",
        "@smithery/cli@latest",
        "run",
        "@ErickWendel/erickwendel-contributions-mcp"
      ]
    }
  }
}
```
3.  Run MCPHost with your preferred Ollama model:
```bash
ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME
```

## Tools

## Available Tools

1.  `get-talks` (Retrieves a paginated list of talks with optional filtering, supporting filtering by various criteria and returning counts grouped by language, country, or city).
2.  `get-posts` (Fetches posts with optional filtering and pagination, supporting filtering by ID, title, language, and portal).
3.  `get-videos` (Retrieves videos with optional filtering and pagination, supporting filtering by ID, title, and language).
4.  `check-status` (Verifies if the API is alive and responding).