erickwendel-contributions-mcp

一个提供工具来查询Erick Wendel的贡献的模型上下文协议（MCP）服务器。通过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

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

设置

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

node -v
#v23.9.0

1. 克隆此仓库：

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

1. 恢复依赖项：

npm ci

与AI工具集成

Cursor设置

1. 打开Cursor设置

2. 导航到MCP部分

3. 单击“添加新的MCP服务器”

4. 配置服务器：

   名称 = erickwendel-contributions
   类型 = 命令
   命令 = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
   

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

   名称 = erickwendel-contributions
   类型 = 命令
   命令 = 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"
      ]
    }
  }
}

1. 确保Cursor聊天处于代理模式，通过在左下角下拉菜单中选择“Agent”

2. 转到聊天并询问“2024年发布了多少关于JavaScript的视频”

Claude桌面版设置

通过Smithery安装

要通过Smithery自动为Claude桌面版安装Erick Wendel贡献：

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

注意：目前通过Smithery CLI为Claude安装时遇到问题。请使用下面的手动安装方法直到该问题解决。

手动设置

1. 转到 Claude 设置
2. 点击开发者标签页
3. 点击编辑配置
4. 在代码编辑器中打开配置
5. 将以下配置添加到你的 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"
      ]
    }
  }
}

1. 保存文件并重启 Claude Desktop
2. 再次打开开发者标签页，检查其是否处于“运行”状态，如下所示：

1. 转到聊天界面并询问 "有关于 RAG 的视频吗？"

使用 MCPHost 的免费替代方案

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

1. 安装 MCPHost：

go install github.com/mark3labs/mcphost@latest

1. 创建一个配置文件（例如 ./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"
      ]
    }
  }
}

1. 使用你首选的 Ollama 模型运行 MCPHost：

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

示例查询

这里有一些你可以向 Claude、Cursor 或任何 MCP 客户端提出的查询示例：

1. "2023 年有多少场演讲？"

1. "给我看看西班牙语的演讲"

1. "找到关于 WebXR 的帖子"

开发

特性

• 使用 Model Context Protocol (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

对于带有 watch 的开发模式：

npm run test:dev

贡献

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

作者

Erick Wendel

许可证

本项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。