贡献查询工具

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

作者 By ErickWendel
本地部署 自然语言查询 贡献管理
GitHub

埃里克温德尔贡献mcp

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

快速开始

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

JSON``` 1 2 3 4 5 6 7 8{ “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服务器的功能:


BASH```
1npm run inspect

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

设置

  1. 确保你使用的是Node.js v20+

BASH``` 1 2node -v

v20.x.x or higher


1. 克隆此存储库:


BASH```
1
2git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp
  1. 安装依赖项:

BASH``` 1npm ci


1. 运行服务器:


BASH```
1npm start

与AI工具集成

光标设置

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

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “erickwendel-contributions”: { “command”: “npx”, “args”: [“-y”, “@erickwendel/contributions-mcp”] } } }





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





#### 本地开发


对于本地开发,使用项目的绝对路径:


JSON```
1
2
3
4
5
6
7
8{
  "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):

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “erickwendel-contributions”: { “command”: “npx”, “args”: [“-y”, “@erickwendel/contributions-mcp”] } } }


#### 本地开发


对于本地开发,使用项目的绝对路径:


JSON```
1
2
3
4
5
6
7
8{
  "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:

BASH``` 1go install github.com/mark3labs/mcphost@latest


1. 创建配置文件(例如。 ./mcp.json):


JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}
  1. 与Ollama一同奔跑:

BASH``` 1 2ollama pull MODEL_NAME mcphost —config ./mcp.jsonc -m ollama:MODEL_NAME


#### 本地开发


对于本地开发,请更新配置:


JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

查询示例

以下是您可以向Claude、Cursor或任何MCP客户端提出的查询示例:

  1. “2023年举行了多少次会谈?”

  2. “给我看西班牙语演讲”

  3. “查找关于WebXR的帖子”

发展

特性

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

注意:此项目需要Node.js v23+,因为它使用去年添加的原生TypeScript支持。

建筑

代码库遵循模块化结构:

1
2
3
4
5
6
7src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

测试

要运行测试套件,请执行以下操作:

BASH``` 1npm test


对于带手表的开发模式:


BASH```
1npm run test:dev

贡献

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

作者

埃里克·温德尔

许可证

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