MCP 服务器

Erick Wendel Contributions MCP

一个模型上下文协议服务器，它使 AI 代理能够使用自然语言查询 Erick Wendel 在不同平台上发布的演讲、博客文章和视频。

内容获取

AI集成系统

Git管理工具

数据与应用分析

访问服务器

README

erickwendel-contributions-mcp

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

此 MCP 服务器也可在 Smithery 上直接集成。

可用工具

此 MCP 服务器提供以下工具与 API 交互：

get-talks: 检索分页的演讲列表，并可选择过滤
- 支持按 ID、标题、语言、城市、国家和年份进行过滤
- 可以返回按语言、国家或城市分组的计数
get-posts: 获取帖子，并可选择过滤和分页
- 支持按 ID、标题、语言和门户进行过滤
get-videos: 检索视频，并可选择过滤和分页
- 支持按 ID、标题和语言进行过滤
check-status: 验证 API 是否存活并响应

与 AI 工具集成

检查 MCP 服务器功能

您可以使用 Smithery 检查此 MCP 服务器的功能：

npx -y @smithery/cli@latest inspect @ErickWendel/erickwendel-contributions-mcp

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

设置

确保您正在使用 Node.js v23+

node -v
#v23.9.0

克隆此存储库：

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

恢复依赖项：

npm ci

与 AI 工具集成

Cursor 设置

打开 Cursor 设置
导航到 MCP 部分
点击 "Add new MCP server"

配置服务器：

Name = erickwendel-contributions
Type = command
Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts

或者，如果您喜欢从 Smithery 执行它

Name = erickwendel-contributions
Type = command
Command = npm exec -- @smithery/cli@latest run @ErickWendel/erickwendel-contributions-mcp

或者直接从位于 ~/.cursor/mcp.json 的 Cursor 全局 MCP 文件配置，并添加以下内容：

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

或者，如果您喜欢从 Smithery 执行它

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

确保 Cursor 聊天处于 Agent 模式，方法是在左下角下拉菜单中选择 "Agent"
进入聊天并询问 "how many videos were published about JavaScript in 2024"

Claude Desktop 设置

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Erick Wendel Contributions：

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

注意: 用于 Claude 的 Smithery CLI 安装目前遇到问题。请使用下面的手动安装方法，直到问题解决。

手动设置

进入 Claude 设置
点击 Developer 选项卡
点击 edit config
在代码编辑器中打开配置
将以下配置添加到您的 Claude Desktop 配置中：

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

或者，如果您喜欢从 Smithery 执行它

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

保存文件并重启 Claude Desktop
再次打开 Developer 选项卡，并检查它是否处于 "running" 状态，如下所示：

进入聊天并询问 "Are there videos about RAG?"

使用 MCPHost 的免费替代方案

如果您无法访问 Claude Desktop 或 Cursor，您可以使用 MCPHost 和 Ollama 作为免费替代方案。MCPHost 是一个 CLI 工具，使大型语言模型能够与 MCP 服务器交互。

安装 MCPHost：

go install github.com/mark3labs/mcphost@latest

创建一个配置文件（例如 ./mcp.jsonc）：

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

或者，如果您喜欢从 Smithery 执行它

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

使用您首选的 Ollama 模型运行 MCPHost：

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

示例查询

以下是一些您可以向 Claude、Cursor 或任何 MCP 客户端提出的查询示例：

"How many talks were given in 2023?"

"Show me talks in Spanish"

"Find posts about WebXR"

开发

特性

使用模型上下文协议 (MCP) 构建
使用 TypeScript 和 Zod 模式验证实现类型安全
Node.js 中对 TypeScript 的原生支持，无需转译
使用 GenQL 生成的 SDK
具有关注点分离的模块化架构
标准 I/O 传输，易于集成
结构化错误处理
兼容 Claude Desktop、Cursor 和 MCPHost（免费替代方案）

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

架构

代码库遵循模块化结构：

src/
  ├── config/      # 配置设置
  ├── types/       # TypeScript 接口和类型
  ├── tools/       # MCP 工具实现
  ├── utils/       # 实用程序函数
  ├── services/    # API 服务层
  └── index.ts     # 主入口点