Skip to main content
Glama
Erick Wendel Contributions MCP

Erick Wendel Contributions MCP

by ErickWendel

erickwendel-contributions-mcp

CI Status npm version npm downloads

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

Related MCP server: MCP TabNews Integration

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
  1. Clone this repository:

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

npm ci
  1. 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

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"]
    }
  }
}

MCPHost with Ollama (Free Alternative)

If you don't have access to Claude Desktop or Cursor, you can use MCPHost with Ollama as a free alternative.

  1. Install MCPHost:

go install github.com/mark3labs/mcphost@latest
  1. Create a config file (e.g. ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}
  1. Run with Ollama:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Local Development

For local development, update the config:

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

Example Queries

Here are some examples of queries you can ask Claude, Cursor or any MCP Client:

  1. "How many talks were given in 2023?"

  1. "Show me talks in Spanish"

  1. "Find posts about WebXR"

Development

Features

  • Built with Model Context Protocol (MCP)

  • Full MCP Capabilities: Tools, Prompts, and Resources

  • Type-safe with TypeScript and Zod schema validation

  • Native TypeScript support in Node.js without transpilation

  • Generated SDK using GenQL

  • Modular architecture with separation of concerns

  • Standard I/O transport for easy integration

  • Structured error handling

  • Compatible with Claude Desktop, Cursor, and MCPHost (free alternative)

Note: This project requires Node.js v23+ as it uses the native TypeScript support added in the last year.

Architecture

The codebase follows a modular structure:

src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

Testing

To run the test suite:

npm test

For development mode with watch:

npm run test:dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Erick Wendel

License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

4 tools
check_statusA

Check if the API is alive and responding.

Inputs: no named parameters.

get_postsB

Get a list of posts with optional filtering and pagination.

Inputs: id, title, language, portal, +2 more.

get_talksC

Get a list of talks with optional filtering and pagination.

Inputs: id, title, language, city, +6 more.

get_videosC

Get a list of videos with optional filtering and pagination.

Inputs: id, title, language, skip, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting different resource types: API status, posts, talks, and videos. There is no overlap in functionality, making it easy for an agent to select the correct tool without confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (check_status, get_posts, get_talks, get_videos), using snake_case throughout. This predictability enhances readability and usability for agents.

    Tool Count4/5

    With 4 tools, the count is reasonable for a contributions-focused server, covering status and three content types. It feels slightly thin but well-scoped, as each tool serves a distinct purpose without unnecessary bloat.

    Completeness3/5

    The toolset provides read-only access to posts, talks, and videos with filtering and pagination, which is adequate for retrieval. However, there are notable gaps: no create, update, or delete operations, limiting full lifecycle management of contributions in the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A flexible Model Context Protocol server that makes documentation or codebases searchable by AI assistants, allowing users to chat with code or docs by simply pointing to a git repository or folder.
      1
      92
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
      90
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      An experimental Model Context Protocol server that enables AI assistants to access information about Duyet, including his CV, blog posts, and GitHub activity through natural language queries.
      8
      2
      -