erickwendel-contributions-mcp

erickwendel-contributions-mcp

一个 Model Context Protocol（MCP）服务，提供用于查询 Erick Wendel 的贡献的工具，涵盖多个平台。通过 Claude、Cursor 或类似工具，使用自然语言查询演讲、博客文章和视频。本项目使用 Cursor IDE 和默认 Agent（试用版）构建。

快速开始

无需安装，即可将此 MCP 服务与 Claude Desktop 或 Cursor 搭配使用：

{
  "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

可用工具

此 MCP 服务提供以下功能：

工具

• get-talks：获取演讲的分页列表，并支持可选筛选

  • 支持按 ID、标题、语言、城市、国家和年份筛选
  • 可返回按语言、国家或城市分组的计数

• get-posts：获取文章，并支持可选筛选和分页

  • 支持按 ID、标题、语言和门户网站筛选

• get-videos：获取视频，并支持可选筛选和分页

  • 支持按 ID、标题和语言筛选

• check-status：检查 API 是否正常运行并能响应

提示词

• 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”，然后询问“2024 年发布了多少个关于 JavaScript 的视频”：

本地开发

进行本地开发时，请使用项目的绝对路径：

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

Claude Desktop 设置

1. 前往 Claude 设置
2. 点击 Developer 选项卡
3. 点击 edit config
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. “2023 年举办了多少场演讲？”

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

3. “查找关于 WebXR 的文章”

开发

功能

• 基于 Model Context Protocol (MCP) 构建
• 完整的 MCP 能力：工具、提示词和资源
• 使用 TypeScript 和 Zod 架构验证，确保类型安全
• Node.js 原生支持 TypeScript，无需转译
• 使用 GenQL 生成的 SDK
• 采用模块化架构，职责分离
• 标准输入/输出传输方式，便于集成
• 结构化错误处理
• 兼容 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 授权，详情请参阅 LICENSE 文件。