🚀 MCP 与 TabNews 集成
本项目实现了 TabNews 的 Model Context Protocol (MCP) 集成，可让你方便地与 TabNews 进行交互。此 MCP 服务器还能直接在 Smithery 上使用，无需额外配置。
✨ 主要特性
- 使用 Model Context Protocol (MCP) 构建。
- 型安全，使用 TypeScript 和 Zod 模式验证。
- Node.js 中原生 TypeScript 支持，无需转译。
- 采用标准 I/O 传输协议。
- 包含详细文档和示例代码。
📦 安装指南
手动安装
- 确保使用 Node.js v23+ 版本：
node -v
#v23.11.0
- 克隆此仓库：
git clone https://github.com/renant/mcp-tabnews.git
cd mcp-tabnews
- 恢复依赖项：
npm ci
💻 使用示例
检查 MCP 服务器功能
使用 Smithery 可以检查此 MCP 服务器的功能：
npx -y @smithery/cli@latest inspect @renant/mcp-tabnews
这将显示所有可用工具、它们的参数以及如何使用。
📚 详细文档
可用工具
checkStatusTool：检查 TabNews API 状态。getContentsTool：从 TabNews 获取内容。getContentsByUserTool：按用户从 TabNews 获取内容。getContentTool：通过用户和文章 slug 从 TabNews 获取带有正文的内容。getContentChildrenTool：获取 TabNews 某篇文章的评论。getAnalyticsUserCreatedTool：获取某个用户创建内容的分析数据。getAnalyticsRootContentPublishedTool：获取已发布的根内容的分析数据。getAnalyticsChildContentPublishedTool：获取子内容发布的分析数据。getRssFeedTool：获取 TabNews 的 RSS 源。
与 AI 工具集成
Cursor 设置
- 打开 Cursor 设置。
- 导航到 MCP 部分。
- 点击“添加新的 MCP 服务器”。
- 配置服务器：
名称 = mcp-tabnews
类型 = 命令
命令 = node 绝对路径项目目录 /src/index.ts
或者从 Smithery 执行：
名称 = mcp-tabnews
类型 = 命令
命令 = npm exec -- @smithery/cli@latest run @renant/mcp-tabnews
或者直接在 Cursor 的全局 MCP 文件 ~/.cursor/mcp.json 中添加以下内容：
{
"mcpServers": {
"mcp-tabnews": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
}
}
}
或者从 Smithery 执行：
{
"mcpServers": {
"mcp-tabnews": {
"command": "npm",
"args": [
"exec",
"--",
"@smithery/cli@latest",
"run",
"@renant/mcp-tabnews"
]
}
}
}
- 确保 Cursor 聊天处于“代理”模式，位于左下角下拉菜单中选择“代理”。
- 前往聊天并询问任何关于 TabNews 的问题。
Claude Desktop 设置
通过 Smithery 安装
要通过 Smithery 自动安装 TabNews 用于 Claude Desktop：
npx -y @smithery/cli install @renant/mcp-tabnews --client claude
🔧 技术细节
- MCP 协议：实现了通用的模型上下文协议，支持分布式 AI 系统。
- 可扩展性：设计上支持大规模扩展，适用于高并发场景。
- 模块化架构：各个功能模块独立开发，便于维护和升级。
🤝 贡献指南
- 请在提交代码前阅读并遵循我们的 贡献规范。
- 提交问题到 GitHub Issues。
- 欢迎 fork 仓库并在自己的分支上进行开发。
👥 贡献者
- [@renant] - 项目发起人和主要开发者。
- 其他贡献者名单将在未来的更新中添加。
📄 许可证
[项目许可证信息]