AI导哈

贡献查询工具

一个用于查询Erick Wendel在不同平台上的贡献（如演讲、博客文章和视频）的模型上下文协议（MCP）服务器，支持通过自然语言进行查询。

  • by ErickWendel
  • TypeScript
  • 本地部署
  • 383 星标
  • 更新于
在 GitHub 查看 ErickWendel/erickwendel-contributions-mcp

使用说明

埃里克温德尔贡献mcp

提供查询工具的模型上下文协议（MCP）服务器 埃里克·温德尔的贡献 跨不同平台。通过Claude、Cursor或类似工具使用自然语言查询对话、博客文章和视频。该项目是使用 光标 带有默认代理的IDE（试用版）。

快速开始

直接将此MCP服务器与Claude Desktop或Cursor一起使用，无需安装：

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

将此配置添加到：

  • 克劳德桌面: ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）
  • 光标: ~/.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检查器检查此MCP服务器的功能：

npm run inspect

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

设置

  1. 确保你使用的是Node.js v20+
node -v
# v20.x.x or higher
  1. 克隆此存储库：
git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
  1. 安装依赖项：
npm ci
  1. 运行服务器：
npm start

与AI工具集成

光标设置

将以下配置添加到 ~/.cursor/mcp.json:

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

在左下角的下拉菜单中选择“Agent”，然后询问“2024年发布了多少关于JavaScript的视频”，以确保Cursor聊天处于Agent模式：

本地开发

对于本地开发，使用项目的绝对路径：

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

Claude桌面设置

  1. 转到Claude设置
  2. 在“开发人员”选项卡中单击
  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"]
    }
  }
}

MCPHost与Ollama（免费替代品）

如果您没有访问Claude Desktop或Cursor的权限，可以使用 MCP主机 Ollama是一个免费的替代品。

  1. 安装MCPHost：
go install github.com/mark3labs/mcphost@latest
  1. 创建配置文件（例如。 ./mcp.json):
{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}
  1. 与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年举行了多少次会谈？”
  1. “给我看西班牙语演讲”
  1. “查找关于WebXR的帖子”

发展

特性

  • 使用模型上下文协议（MCP）构建
  • 完整的MCP功能：工具、提示和资源
  • 使用TypeScript和Zod模式验证进行类型安全
  • Node.js中的原生TypeScript支持，无需转译
  • 使用生成的SDK GenQL
  • 关注点分离的模块化架构
  • 标准I/O传输，便于集成
  • 结构化错误处理
  • 与Claude桌面、光标和 MCP主机 （免费替代）

注意：此项目需要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

贡献

欢迎投稿！请随时提交拉取请求。

作者

埃里克·温德尔

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP