erickwendel-contributions-mcp

一个模型上下文协议 (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

2. 克隆此仓库：

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

3. 安装依赖：

npm ci

4. 运行服务器：

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

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

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

3. 使用 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?"

2. "Show me talks in Spanish"

3. "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 文件。