License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

ErickWendel / erickwendel-contributions-mcp Public

• Notifications
  You must be signed in to change notification settings

• Fork 10

• Star 54

A Model Context Protocol (MCP) server that provides tools to query Erick Wendel's contributions across different platforms

smithery.ai/server/@ErickWendel/erickwendel-contributions-mcp

License

MIT license

54 stars
10 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

ErickWendel/erickwendel-contributions-mcp

main

2 Branches
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


ErickWendel

Update refs.txt

Mar 15, 2025

4a005c8
 · Mar 15, 2025

History
-------

21 Commits

| | |
| .github/workflows | | .github/workflows | add initial code | Mar 14, 2025 |
| demos | | demos | add more examples | Mar 15, 2025 |
| erickwendel-sdk | | erickwendel-sdk | add initial code | Mar 14, 2025 |
| src | | src | trying to fix smithery | Mar 14, 2025 |
| test | | test | add initial code | Mar 14, 2025 |
| .gitignore | | .gitignore | add initial code | Mar 14, 2025 |
| .nvmrc | | .nvmrc | add initial code | Mar 14, 2025 |
| Dockerfile | | Dockerfile | fixing smithery | Mar 14, 2025 |
| LICENSE | | LICENSE | chaging readme | Mar 14, 2025 |
| README.md | | README.md | improving | Mar 15, 2025 |
| mcp.jsonc | | mcp.jsonc | add conf from smithery | Mar 15, 2025 |
| package-lock.json | | package-lock.json | add initial code | Mar 14, 2025 |
| package.json | | package.json | fixing smithery | Mar 14, 2025 |
| refs.txt | | refs.txt | Update refs.txt | Mar 15, 2025 |
| smithery.yaml | | smithery.yaml | trying to fix smithery | Mar 14, 2025 |
| View all files | | |

Repository files navigation

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

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

Setup

1. Make sure you're using Node.js v23+

node -v
#v23.9.0

1. Clone this repository:

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

1. Restore dependencies:

npm ci

Integration with AI Tools

Cursor Setup

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
   

   or 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:

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

or if you prefer executing it from Smithery

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [\
        "exec",\
        "--",\
        "@smithery/cli@latest",\
        "run",\
        "@ErickWendel/erickwendel-contributions-mcp"\
      ]
    }
  }
}

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

2. 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
:

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.

Manual Setup

1. Go to Claude settings
2. Click in the Developer tab
3. Click in edit config
4. Open the config in a code editor
5. Add the following configuration to your Claude Desktop config:

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

or if you prefer executing it from Smithery

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [\
        "exec",\
        "--",\
        "@smithery/cli@latest",\
        "run",\
        "@ErickWendel/erickwendel-contributions-mcp"\
      ]
    }
  }
}

1. Save file and Restart Claude Desktop
2. Open the Developer tab again and check if it's in the "running" state as follows:

1. 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.

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"]
    }
  }
}

or if you prefer executing it from Smithery

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npm",
      "args": [\
        "exec",\
        "--",\
        "@smithery/cli@latest",\
        "run",\
        "@ErickWendel/erickwendel-contributions-mcp"\
      ]
    }
  }
}

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"

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:

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.

About

A Model Context Protocol (MCP) server that provides tools to query Erick Wendel's contributions across different platforms

smithery.ai/server/@ErickWendel/erickwendel-contributions-mcp

Topics

graphql
large-language-models
llm
model-context-protocol
vibe-coding
model-context-protocol-servers

Resources

Readme

License

MIT license

Activity

Stars

54 stars

Watchers

1 watching

Forks

10 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• TypeScript 99.9%

• Dockerfile 0.1%

You can’t perform that action at this time.