Erick Wendel Contributions

erickwendel-contributions-mcp

CI Status ![smithery badge](https://smithery.ai/badge/@ErickWendel/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).

This MCP server is also available on Smithery for direct integration.

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

get-posts: Fetches posts with optional filtering and pagination

get-videos: Retrieves videos with optional filtering and pagination

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:

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

Setup

Make sure you're using Node.js v23+

Clone this repository:

Restore dependencies:

Integration with AI Tools

Cursor Setup

Open Cursor Settings

Navigate to MCP section

Click "Add new MCP server"

Configure the server:or if you prefer executing it from Smithery

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

or if you prefer executing it from Smithery

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

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:

Note: The Smithery CLI installation for Claude is currently experiencing issues. Please use the manual installation method below until this is resolved.

Manual Setup

Go to Claude settings

Click in the Developer tab

Click in edit config

Open the config in a code editor

Add the following configuration to your Claude Desktop config:

or if you prefer executing it from Smithery

Save file and Restart Claude Desktop

Open the Developer tab again and check if it's in the "running" state as follows:

Go to the chat and ask "Are there videos about RAG?"

Free Alternative Using MCPHost

If you don't have access to Claude Desktop nor Cursor, you can use MCPHost with Ollama as a free alternative. MCPHost is a CLI tool that enables Large Language Models to interact with MCP servers.

Install MCPHost:

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

or if you prefer executing it from Smithery

Run MCPHost with your preferred Ollama model:

Example Queries

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

"How many talks were given in 2023?"

"Show me talks in Spanish"

"Find posts about WebXR"

Development

Features

Built with Model Context Protocol (MCP)

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:

Testing

To run the test suite:

For development mode with watch:

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.