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
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 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
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:
Name = erickwendel-contributions Type = command Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.tsor 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:
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
License
This project is licensed under the MIT License - see the LICENSE file for details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants to retrieve user information, search videos by ID, and find content by keywords on bilibili.com.Last updated -33413MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants and applications to access IQ.wiki data, enabling retrieval of specific wikis, user-created wikis, user-edited wikis, and detailed wiki activities.Last updated -5241MIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server that enables AI assistants to interact with LinkedIn APIs for profile management, content creation, networking, messaging, and analytics.Last updated -1
- -securityFlicense-qualityA comprehensive Model Context Protocol server that enables AI assistants to search and retrieve content from Reddit, YouTube, and Twitter through simple API calls.