埃里克温德尔贡献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
这将向您展示所有可用的工具、它们的参数以及如何使用它们。
设置
- 确保你使用的是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
- 安装依赖项:
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桌面设置
- 转到Claude设置
- 在“开发人员”选项卡中单击
- 在编辑配置中单击
- 在代码编辑器中打开配置
- 将以下配置添加到
~/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是一个免费的替代品。
- 安装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"]
}
}
}
- 与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客户端提出的查询示例:
-
“2023年举行了多少次会谈?”
-
“给我看西班牙语演讲”
-
“查找关于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许可证获得许可-请参阅 许可证 文件以获取详细信息。