README.md•3.61 kB
# MCP TabNews Integration
[](https://smithery.ai/server/@renant/mcp-tabnews)
A Model Context Protocol (MCP) integration for TabNews.
This MCP server is also available on [Smithery](https://smithery.ai/server/@renant/mcp-tabnews) for direct integration.
<a href="https://glama.ai/mcp/servers/@renant/mcp-tabnews">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@renant/mcp-tabnews/badge" alt="TabNews Integration MCP server" />
</a>
## Available Tools
- `checkStatusTool`: Check the status of the TabNews API.
- `getContentsTool`: Get contents from TabNews.
- `getContentsByUserTool`: Get contents from TabNews by user.
- `getContentTool`: Get a content with body from TabNews by user and slug.
- `getContentChildrenTool`: Get comments from TabNews by content.
- `getAnalyticsUserCreatedTool`: Get the analytics of a user created contents from TabNews.
- `getAnalyticsRootContentPublishedTool`: Get the analytics of a root content published from TabNews.
- `getAnalyticsChildContentPublishedTool`: Get the analytics of a child content published from TabNews.
- `getRssFeedTool`: Get the RSS feed from TabNews.
# Integration with AI Tools
## Inspect MCP Server Capabilities
You can inspect this MCP server's capabilities using Smithery:
```bash
npx -y @smithery/cli@latest inspect @renant/mcp-tabnews
```
This will show you all available tools, their parameters, and how to use them.
## Setup
### Manual Installation
1. Make sure you're using Node.js v23+
```bash
node -v
#v23.11.0
```
2. Clone this repository:
```bash
git clone https://github.com/renant/mcp-tabnews.git
cd mcp-tabnews
```
3. Restore dependencies:
```bash
npm ci
```
## Integration with AI Tools
### Cursor Setup
1. Open Cursor Settings
2. Navigate to MCP section
3. Click "Add new MCP server"
4. Configure the server:
```
Name = mcp-tabnews
Type = command
Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
```
or if you prefer executing it from Smithery
```
Name = mcp-tabnews
Type = command
Command = npm exec -- @smithery/cli@latest run @renant/mcp-tabnews
```
or configure directly from the Cursor's global MCP file located in `~/.cursor/mcp.json` and add the following:
```json
{
"mcpServers": {
"mcp-tabnews": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
}
}
}
```
or if you prefer executing it from Smithery
```json
{
"mcpServers": {
"mcp-tabnews": {
"command": "npm",
"args": [
"exec",
"--",
"@smithery/cli@latest",
"run",
"@renant/mcp-tabnews"
]
}
}
}
```
5. Make sure Cursor chat is in Agent mode by selecting "Agent" in the lower left side dropdown
6. Go to the chat an ask any question about TabNews
### Claude Desktop Setup
#### Installing via Smithery
To install TabNews for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@renant/mcp-tabnews):
```bash
npx -y @smithery/cli install @renant/mcp-tabnews --client claude
```
# Development
## Features
- Built with Model Context Protocol (MCP)
- Type-safe with TypeScript and Zod schema validation
- Native TypeScript support in Node.js without transpilation
- Standard I/O transport for easy integration
- Structured error handling
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Author
[Renan Teixeira](https://renant.is-a.dev)
## License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.