Erick Wendel Contributions MCP

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • 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

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 (free version).

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

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)

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

Setup

  1. Clone this repository:
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git cd erickwendel-contributions-mcp
  1. Restore dependencies:
npm ci

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
    • 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

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

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

Integration with AI Tools

Installing via Smithery

To install Erick Wendel Contributions for Claude Desktop automatically via Smithery:

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

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

Installing from the source (this repo)

  1. Open Cursor Settings
  2. Navigate to MCP section
  3. Click "Add new MCP server"
  4. Configure the server:
    Name = erickwendel-contributions Type = command Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
  5. Make sure Cursor chat is in Agent mode by selecting "Agent" in the lower left side dropdown

Claude Desktop Setup

Add the following configuration to your Claude Desktop config:

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

Free Alternative Using MCPHost

If you don't have access to Claude, 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.

  1. Install MCPHost:
go install github.com/mark3labs/mcphost@latest
  1. Create a config file (e.g., ./mcp.jsonc`):
{ "mcpServers": { "erickwendel-contributions": { "command": "node", "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"] } } }
  1. 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 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"

  1. "Are there videos about RAG?"

Development

The project uses TypeScript natively in Node.js. The SDK was generated using:

  1. The GraphQL API at https://tml-api.herokuapp.com/graphiql
  2. GenQL to generate the TypeScript SDK
  3. File extensions were changed to .ts to enable native TypeScript support

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Features
    1. Architecture
      1. Setup
        1. Available Tools
          1. Integration with AI Tools
            1. Inspect MCP Server Capabilities
              1. Integration with AI Tools
                1. Installing via Smithery
                  1. Installing from the source (this repo)
                    1. Claude Desktop Setup
                      1. Free Alternative Using MCPHost
                      2. Example Queries
                        1. Development
                          1. Testing
                            1. Contributing
                              1. Author
                                1. License