Skip to main content
Glama
erickwendel-contributions-mcp

erickwendel-contributions-mcp

by jdoliveirasa

erickwendel-contributions-mcp

CI Status npm version npm downloads

一个模型上下文协议 (MCP) 服务器,提供用于查询 Erick Wendel 的贡献 的工具,涵盖不同平台。通过 Claude、Cursor 或类似工具,使用自然语言查询演讲、博客文章和视频。本项目是使用 Cursor IDE 及其默认代理(试用版)构建的。

快速开始

无需安装,直接在 Claude Desktop 或 Cursor 中使用此 MCP 服务器:

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

将此配置添加到:

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

  • Cursor: ~/.cursor/mcp.json

Related MCP server: mintlify-mcp

可用工具

此 MCP 服务器提供以下功能:

工具

  • get-talks: 获取分页的演讲列表,支持可选过滤

    • 支持按 ID、标题、语言、城市、国家和年份进行过滤

    • 可以返回按语言、国家或城市分组的计数

  • get-posts: 获取文章,支持可选过滤和分页

    • 支持按 ID、标题、语言和门户进行过滤

  • get-videos: 获取视频,支持可选过滤和分页

    • 支持按 ID、标题和语言进行过滤

  • check-status: 验证 API 是否存活并响应

提示词 (Prompts)

  • find-content: 生成查询以按类型、主题和语言查找特定内容

  • summarize-activity: 创建按年份划分的内容活动摘要

资源

  • erickwendel://about: 服务器信息和功能元数据

  • erickwendel://statistics: 内容统计信息和可用查询

与 AI 工具集成

检查 MCP 服务器功能

您可以使用 MCP Inspector 检查此 MCP 服务器的功能:

npm run inspect

这将向您展示所有可用的工具、它们的参数以及如何使用它们。

设置

  1. 确保您使用的是 Node.js v20+

node -v
# v20.x.x or higher
  1. 克隆此仓库:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
  1. 安装依赖:

npm ci
  1. 运行服务器:

npm start

与 AI 工具集成

Cursor 设置

将以下配置添加到 ~/.cursor/mcp.json:

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

确保 Cursor 聊天处于 Agent 模式(通过选择左下角下拉菜单中的 "Agent"),然后询问 "how many videos were published about JavaScript in 2024":

本地开发

对于本地开发,请使用项目的绝对路径:

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

Claude Desktop 设置

  1. 进入 Claude 设置

  2. 点击 Developer 选项卡

  3. 点击编辑配置

  4. 在代码编辑器中打开配置

  5. 将以下配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

本地开发

对于本地开发,请使用项目的绝对路径:

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

使用 Ollama 的 MCPHost(免费替代方案)

如果您无法访问 Claude Desktop 或 Cursor,可以使用 MCPHost 配合 Ollama 作为免费替代方案。

  1. 安装 MCPHost:

go install github.com/mark3labs/mcphost@latest
  1. 创建配置文件(例如 ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}
  1. 使用 Ollama 运行:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

本地开发

对于本地开发,请更新配置:

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

查询示例

以下是您可以询问 Claude、Cursor 或任何 MCP 客户端的一些查询示例:

  1. "How many talks were given in 2023?"

  1. "Show me talks in Spanish"

  1. "Find posts about WebXR"

开发

特性

  • 基于模型上下文协议 (MCP) 构建

  • 完整的 MCP 功能:工具、提示词和资源

  • 使用 TypeScript 和 Zod 模式验证,类型安全

  • 在 Node.js 中原生支持 TypeScript,无需转译

  • 使用 GenQL 生成 SDK

  • 模块化架构,关注点分离

  • 标准 I/O 传输,易于集成

  • 结构化错误处理

  • 兼容 Claude Desktop、Cursor 和 MCPHost(免费替代方案)

注意:本项目需要 Node.js v23+,因为它使用了去年添加的原生 TypeScript 支持。

架构

代码库遵循模块化结构:

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

测试

运行测试套件:

npm test

以监视模式进行开发:

npm run test:dev

贡献

欢迎贡献!请随时提交 Pull Request。

作者

Erick Wendel

许可证

本项目采用 MIT 许可证 - 有关详细信息,请参阅 LICENSE 文件。

Available Tools

4 tools
check_statusA

Check if the API is alive and responding.

Inputs: no named parameters.

get_postsB

Get a list of posts with optional filtering and pagination.

Inputs: id, title, language, portal, +2 more.

get_talksA

Get a list of talks with optional filtering and pagination.

Inputs: id, title, language, city, +6 more.

get_videosA

Get a list of videos with optional filtering and pagination.

Inputs: id, title, language, skip, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: check_status is for API health, while get_posts, get_talks, and get_videos retrieve different content types. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using underscores (check_status, get_posts, get_talks, get_videos), making them predictable.

    Tool Count5/5

    With 4 tools, the set is well-scoped for a contributions-focused MCP, covering essential retrieval operations without being too sparse or bloated.

    Completeness4/5

    The tool surface provides read operations for all contribution types and a health check, but lacks write or update operations, which may be acceptable for a read-only server but leaves minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables users to query any Mintlify-powered documentation site directly from Claude. It leverages Mintlify's AI Assistant API to provide RAG-based answers and code examples for various platforms like Agno, Resend, and Upstash.
      16 npm
      18
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that ingests various data sources and uses LLMs to compile them into structured knowledge pages, enabling hybrid search and integration with AI coding tools like Claude Code and Cursor.
      1
      MIT