MCP Tabnews

🚀 MCP 与 TabNews 集成

本项目实现了 TabNews 的 Model Context Protocol (MCP) 集成，可让你方便地与 TabNews 进行交互。此 MCP 服务器还能直接在 Smithery 上使用，无需额外配置。

✨ 主要特性

• 使用 Model Context Protocol (MCP) 构建。
• 型安全，使用 TypeScript 和 Zod 模式验证。
• Node.js 中原生 TypeScript 支持，无需转译。
• 采用标准 I/O 传输协议。
• 包含详细文档和示例代码。

📦 安装指南

手动安装

1. 确保使用 Node.js v23+ 版本：

node -v
#v23.11.0

2. 克隆此仓库：

git clone https://github.com/renant/mcp-tabnews.git
cd mcp-tabnews

3. 恢复依赖项：

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 设置

1. 打开 Cursor 设置。
2. 导航到 MCP 部分。
3. 点击“添加新的 MCP 服务器”。
4. 配置服务器：

名称 = 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"
      ]
    }
  }
}

5. 确保 Cursor 聊天处于“代理”模式，位于左下角下拉菜单中选择“代理”。
6. 前往聊天并询问任何关于 TabNews 的问题。

Claude Desktop 设置

通过 Smithery 安装

要通过 Smithery 自动安装 TabNews 用于 Claude Desktop：

npx -y @smithery/cli install @renant/mcp-tabnews --client claude

🔧 技术细节

• MCP 协议：实现了通用的模型上下文协议，支持分布式 AI 系统。
• 可扩展性：设计上支持大规模扩展，适用于高并发场景。
• 模块化架构：各个功能模块独立开发，便于维护和升级。

🤝 贡献指南

1. 请在提交代码前阅读并遵循我们的 贡献规范。
2. 提交问题到 GitHub Issues。
3. 欢迎 fork 仓库并在自己的分支上进行开发。

👥 贡献者

• [@renant] - 项目发起人和主要开发者。
• 其他贡献者名单将在未来的更新中添加。

📄 许可证

[项目许可证信息]