This MCP server enables natural language querying of Erick Wendel's contributions (talks, blog posts, and videos) through AI tools like Claude and Cursor.
Core Tools:
get_talks: Filter by ID, title, language (Spanish/English/Portuguese), city, country, or year; supports pagination, count-only mode, and aggregated grouping by language/country/city
get_posts: Filter by ID, title, language, or portal with pagination support
get_videos: Filter by ID, title, or language with pagination
check_status: Verify API health and availability
Prompts:
find-content: Generate queries to locate specific content by type, topic, and language
summarize-activity: Create content activity summaries by year
Resources:
erickwendel://about: Server information and capabilities metadata
erickwendel://statistics: Content statistics and available queries
Integration & Development:
Compatible with Claude Desktop, Cursor IDE, and MCPHost (with Ollama)
Easy setup via npx without installation
Type-safe TypeScript with Zod validation, modular architecture, and structured error handling
Integrates with a GraphQL API at tml-api.herokuapp.com to fetch data about Erick Wendel's talks, posts, and videos with filtering capabilities
Connects to a GraphQL API hosted on Heroku to fetch and filter Erick Wendel's contributions data
Runs natively in Node.js environment without transpilation, providing tools for querying Erick Wendel's content
Supports integration with Ollama through MCPHost as a free alternative to Claude, enabling LLMs to interact with the MCP server
Built with TypeScript for type safety, with native support in Node.js without requiring transpilation
Uses Zod schema validation to ensure type safety and proper data validation for API requests and responses
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Erick Wendel Contributions MCPshow me talks about Node.js in Portuguese"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
Add this configuration to:
Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)Cursor:
~/.cursor/mcp.json
Related MCP server: MCP-IQWiki
Available Tools
This MCP server provides the following capabilities:
Tools
get-talks: Retrieves a paginated list of talks with optional filteringSupports 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 paginationSupports filtering by ID, title, language, and portal
get-videos: Retrieves videos with optional filtering and paginationSupports 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 languagesummarize-activity: Create summaries of content activity by year
Resources
erickwendel://about: Server information and capabilities metadataerickwendel://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:
This will show you all available tools, their parameters, and how to use them.
Setup
Make sure you're using Node.js v20+
Clone this repository:
Install dependencies:
Run the server:
Integration with AI Tools
Cursor Setup
Add the following configuration to ~/.cursor/mcp.json:
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:
Claude Desktop 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
~/Library/Application Support/Claude/claude_desktop_config.json(macOS):
Local Development
For local development, use the absolute path to the project:
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.
Install MCPHost:
Create a config file (e.g. ./mcp.jsonc):
Run with Ollama:
Local Development
For local development, update the config:
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)
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:
Testing
To run the test suite:
For development mode with watch:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Author
License
This project is licensed under the MIT License - see the LICENSE file for details.