📌Overview

Purpose: To provide a robust server for querying Erick Wendel's contributions across multiple platforms using natural language interfaces.

Overview: The Model Context Protocol (MCP) server facilitates users in retrieving information about Erick Wendel’s talks, blog posts, and videos through intuitive queries. It is designed for easy integration with AI tools like Cursor and Claude, allowing users to access content in a conversational manner.

Key Features:

• get-talks: Retrieves a paginated list of talks, allowing filtering by various attributes such as ID, title, language, city, country, and year, enhancing the user's research capabilities.

• get-posts: Fetches a list of blog posts with optional filters, aiding users in easily locating relevant content through specific queries.

• get-videos: Provides access to video content, including filtering options by ID, title, and language, ensuring users can find the exact media they need.

• check-status: Confirms the operational status of the API, ensuring reliability and responsiveness for users.

• Integration Capabilities: Offers seamless integration with AI tools and platforms, ensuring compatibility and enhancing user experience.

---

Erick Wendel Contributions MCP

A Model Context Protocol (MCP) server that provides tools to query Erick Wendel's contributions across different platforms. Users can query talks, blog posts, and videos using natural language through AI tools like Claude and Cursor.

Available Tools

This MCP server provides the following tools to interact with the API:

• get-talks: Retrieves a paginated list of talks with optional filtering (by ID, title, language, city, country, and year).
• get-posts: Fetches posts with optional filtering and pagination (by ID, title, language, and portal).
• get-videos: Retrieves videos with optional filtering and pagination (by ID, title, and language).
• check-status: Verifies if the API is alive and responding.

Integration with AI Tools

Inspect MCP Server Capabilities

You can inspect this MCP server's capabilities using Smithery:

npx -y @smithery/cli@latest inspect @ErickWendel/erickwendel-contributions-mcp

Setup

1. Ensure you're using Node.js v23+:

   node -v
   

2. Clone this repository:

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

3. Restore dependencies:

   npm ci
   

Cursor Setup

1. Open Cursor Settings and navigate to the MCP section.

2. Click "Add new MCP server" and configure the server:

   Name = erickwendel-contributions
   Type = command
   Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
   

   Alternatively, you can set it up to execute from Smithery:

   Name = erickwendel-contributions
   Type = command
   Command = npm exec -- @smithery/cli@latest run @ErickWendel/erickwendel-contributions-mcp
   

3. Ensure Cursor chat is in Agent mode.

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

Claude Desktop Setup

Installing via Smithery

To install Erick Wendel Contributions for Claude Desktop via Smithery:

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

Note: Installation may currently experience issues; consider the manual setup below.

Manual Setup

1. Go to Claude settings and navigate to the Developer tab.

2. Edit the config file and add the following:

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

3. Save the file and restart Claude Desktop.

4. Check if it's in the "running" state.

Free Alternative Using MCPHost

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
   

2. Create a config file (e.g., ./mcp.jsonc):

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

3. Run MCPHost with your preferred Ollama model:

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

Example Queries

Here are some examples of queries you can ask:

1. "How many talks were given in 2023?"
2. "Show me talks in Spanish."
3. "Find posts about WebXR."

Development

Features

• Built with Model Context Protocol (MCP).
• Type-safe with TypeScript and Zod schema validation.
• Native TypeScript support 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.

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.