Skip to content
Back to search

erickwendel-contributions-mcp

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/erickwendel--erickwendel-contributions-mcp/badge.svg)](/listings/erickwendel--erickwendel-contributions-mcp)

HTML

<a href="/listings/erickwendel--erickwendel-contributions-mcp"><img src="/api/listings/erickwendel--erickwendel-contributions-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use this MCP server directly with Claude Desktop or Cursor without installation:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Add this configuration to: - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) - **Cursor**: `~/.cursor/mcp.json`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 271 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # erickwendel-contributions-mcp
  2. ![CI Status](https://github.com/ErickWendel/erickwendel-contributions-mcp/workflows/Test%20MCP%20Server/badge.svg)
  3. [![npm version](https://badge.fury.io/js/@erickwendel%2Fcontributions-mcp.svg)](https://www.npmjs.com/package/@erickwendel/contributions-mcp)
  4. [![npm downloads](https://img.shields.io/npm/dt/@erickwendel/contributions-mcp.svg)](https://www.npmjs.com/package/@erickwendel/contributions-mcp)
  5. A Model Context Protocol (MCP) server that provides tools to query [Erick Wendel's contributions](https://erickwendel.com.br/) across different platforms. Query talks, blog posts, and videos using natural language through Claude, Cursor or similars. This project was built using [Cursor](https://cursor.sh) IDE with the default agent (trial version).
  6. ## Quick Start
  7. Use this MCP server directly with Claude Desktop or Cursor without installation:
  8. ```json
  9. {
  10. "mcpServers": {
  11. "erickwendel-contributions": {
  12. "command": "npx",
  13. "args": ["-y", "@erickwendel/contributions-mcp"]
  14. }
  15. }
  16. }
  17. ```
  18. Add this configuration to:
  19. - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
  20. - **Cursor**: `~/.cursor/mcp.json`
  21. ## Available Tools
  22. This MCP server provides the following **capabilities**:
  23. ### Tools
  24. - `get-talks`: Retrieves a paginated list of talks with optional filtering
  25. - Supports filtering by ID, title, language, city, country, and year
  26. - Can return counts grouped by language, country, or city
  27. - `get-posts`: Fetches posts with optional filtering and pagination
  28. - Supports filtering by ID, title, language, and portal
  29. - `get-videos`: Retrieves videos with optional filtering and pagination
  30. - Supports filtering by ID, title, and language
  31. - `check-status`: Verifies if the API is alive and responding
  32. ### Prompts
  33. - `find-content`: Generate queries to find specific content by type, topic, and language
  34. - `summarize-activity`: Create summaries of content activity by year
  35. ### Resources
  36. - `erickwendel://about`: Server information and capabilities metadata
  37. - `erickwendel://statistics`: Content statistics and available queries
  38. # Integration with AI Tools
  39. ## Inspect MCP Server Capabilities
  40. You can inspect this MCP server's capabilities using the MCP Inspector:
  41. ```bash
  42. npm run inspect
  43. ```
  44. This will show you all available tools, their parameters, and how to use them.
  45. ## Setup
  46. 1. Make sure you're using Node.js v20+
  47. ```bash
  48. node -v
  49. # v20.x.x or higher
  50. ```
  51. 2. Clone this repository:
  52. ```bash
  53. git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
  54. cd erickwendel-contributions-mcp
  55. ```
  56. 3. Install dependencies:
  57. ```bash
  58. npm ci
  59. ```
  60. 4. Run the server:
  61. ```bash
  62. npm start
  63. ```
  64. ## Integration with AI Tools
  65. ### Cursor Setup
  66. Add the following configuration to `~/.cursor/mcp.json`:
  67. ```json
  68. {
  69. "mcpServers": {
  70. "erickwendel-contributions": {
  71. "command": "npx",
  72. "args": ["-y", "@erickwendel/contributions-mcp"]
  73. }
  74. }
  75. }
  76. ```
  77. ![](./demos/cursor-mcp.png)
  78. 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":
  79. ![](./demos/cursor-videos-in-2024.png)
  80. #### Local Development
  81. For local development, use the absolute path to the project:
  82. ```json
  83. {
  84. "mcpServers": {
  85. "erickwendel-contributions": {
  86. "command": "node",
  87. "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
  88. }
  89. }
  90. }
  91. ```
  92. ### Claude Desktop Setup
  93. 1. Go to Claude settings
  94. 2. Click in the Developer tab
  95. 3. Click in edit config
  96. 4. Open the config in a code editor
  97. 5. Add the following configuration to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
  98. ```json
  99. {
  100. "mcpServers": {
  101. "erickwendel-contributions": {
  102. "command": "npx",
  103. "args": ["-y", "@erickwendel/contributions-mcp"]
  104. }
  105. }
  106. }
  107. ```
  108. #### Local Development
  109. For local development, use the absolute path to the project:
  110. ```json
  111. {
  112. "mcpServers": {
  113. "erickwendel-contributions": {
  114. "command": "node",
  115. "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
  116. }
  117. }
  118. }
  119. ```
  120. ### MCPHost with Ollama (Free Alternative)
  121. If you don't have access to Claude Desktop or Cursor, you can use [MCPHost](https://github.com/mark3labs/mcphost) with Ollama as a free alternative.
  122. 1. Install MCPHost:
  123. ```bash
  124. go install github.com/mark3labs/mcphost@latest
  125. ```
  126. 2. Create a config file (e.g. [./mcp.jsonc](./mcp.jsonc)):
  127. ```json
  128. {
  129. "mcpServers": {
  130. "erickwendel-contributions": {
  131. "command": "npx",
  132. "args": ["-y", "@erickwendel/contributions-mcp"]
  133. }
  134. }
  135. }
  136. ```
  137. 3. Run with Ollama:
  138. ```bash
  139. ollama pull MODEL_NAME
  140. mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME
  141. ```
  142. #### Local Development
  143. For local development, update the config:
  144. ```json
  145. {
  146. "mcpServers": {
  147. "erickwendel-contributions": {
  148. "command": "node",
  149. "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
  150. }
  151. }
  152. }
  153. ```
  154. ## Example Queries
  155. Here are some examples of queries you can ask Claude, Cursor or any MCP Client:
  156. 1. "How many talks were given in 2023?"
  157. ![](./demos/talks-in-2023.jpeg)
  158. 2. "Show me talks in Spanish"
  159. ![](./demos/talks-in-spanish.jpeg)
  160. 3. "Find posts about WebXR"
  161. ![](./demos/posts-webxr.jpeg)
  162. # Development
  163. ## Features
  164. - Built with Model Context Protocol (MCP)
  165. - **Full MCP Capabilities**: Tools, Prompts, and Resources
  166. - Type-safe with TypeScript and Zod schema validation
  167. - Native TypeScript support in Node.js without transpilation
  168. - Generated SDK using [GenQL](https://genql.dev)
  169. - Modular architecture with separation of concerns
  170. - Standard I/O transport for easy integration
  171. - Structured error handling
  172. - Compatible with Claude Desktop, Cursor, and [MCPHost](https://github.com/mark3labs/mcphost) (free alternative)
  173. > Note: This project requires Node.js v23+ as it uses the native TypeScript support added in the last year.
  174. ## Architecture
  175. The codebase follows a modular structure:
  176. ```
  177. src/
  178. ├── config/ # Configuration settings
  179. ├── types/ # TypeScript interfaces and types
  180. ├── tools/ # MCP tool implementations
  181. ├── utils/ # Utility functions
  182. ├── services/ # API service layer
  183. └── index.ts # Main entry point
  184. ```
  185. ## Testing
  186. To run the test suite:
  187. ```bash
  188. npm test
  189. ```
  190. For development mode with watch:
  191. ```bash
  192. npm run test:dev
  193. ```
  194. ## Contributing
  195. Contributions are welcome! Please feel free to submit a Pull Request.
  196. ## Author
  197. [Erick Wendel](https://linktr.ee/erickwendel)
  198. ## License
  199. This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.