erickwendel-contributions-mcp

这是一个模型上下文协议（MCP）服务器，提供工具来查询Erick Wendel的贡献在不同平台上的信息。通过Claude、Cursor或其他类似工具，可以使用自然语言查询演讲、博客文章和视频。该项目使用CursorIDE和默认代理（试用版）构建。

此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

2. 克隆此仓库：

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

3. 恢复依赖项：

npm ci

与AI工具集成

Cursor设置

1. 打开Cursor设置

2. 导航到MCP部分

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

4. 配置服务器：

   名称 = erickwendel-contributions
   类型 = 命令
   命令 = node 绝对路径到项目/src/index.ts
   

   或者如果你更喜欢从Smithery执行

   名称 = erickwendel-contributions
   类型 = 命令
   命令 = npm exec -- @smithery/cli@latest run @ErickWendel/er-ickwendel-contributions-mcp
   

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

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["绝对路径到项目/src/index.ts"]
    }
  }
}

或者如果你更喜欢从Smithery执行

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

5. 确保Cursor聊天处于代理模式，选择左下角下拉菜单中的“代理”

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

Claude Desktop设置

通过Smithery安装

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

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": ["绝对路径到项目/src/index.ts"]
    }
  }
}

或者如果你更喜欢从Smithery执行

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

6. 保存文件并重启Claude Desktop
7. 再次进入开发者标签，检查它是否处于“运行”状态如下所示：

8. 转到聊天并询问“有RAG相关的视频吗？”

使用MCPHost的免费替代方案

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

1. 安装MCPHost：

go install github.com/mark3labs/mcphost@latest

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

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["绝对路径到项目/src/index.ts"]
    }
  }
}

或者如果你更喜欢从Smithery执行

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

3. 使用你喜欢的Ollama模型运行MCPHost：

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

示例查询

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

1. “2023年有多少场演讲？”

2. “展示西班牙语的演讲”

3. “查找关于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     # 主入口点

测试

要运行测试套件：

npm test

开发模式带监视：

npm run test:dev

贡献

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

作者

Erick Wendel

许可证

本项目根据MIT许可证发布 - 查看LICENSE文件以获取详细信息。