Skip to main content

Available Plugins

This page lists official and community plugins for Viben.

Official Plugins​

These plugins are maintained by the Viben team.

Social Media Plugin​

Search and fetch content from social media platforms.

pip install browse-mcp-plugin-social-media
Data SourceDescriptionRequires API Key
githubGitHub repositories and codeOptional (for higher rate limits)
twitterTwitter/X postsYes (TWITTER_BEARER_TOKEN)
zhihuZhihu Q&A articlesOptional
xiaohongshuXiaohongshu postsOptional

Learn more about the Social Media Plugin

Built-in Data Sources​

These data sources are included in the browse-mcp core and require no additional installation.

Academic Data Sources (Free)​

Data SourceDescription
arxivPhysics, mathematics, computer science preprints
pubmedMEDLINE biomedical literature
pmcPubMed Central full-text repository
biorxivBiology preprint server
medrxivHealth sciences preprint server
semanticSemantic Scholar AI-powered search
crossrefCrossRef DOI metadata
google_scholarGoogle Scholar search
coreCORE open access aggregator
iacrIACR cryptography preprints

Academic Data Sources (Paid)​

These require API keys:

Data SourceAPI Key Variable
ieeeIEEE_API_KEY
scopusSCOPUS_API_KEY
springerSPRINGER_API_KEY
sciencedirectSCIENCEDIRECT_API_KEY

Community Plugins​

:::info Coming Soon Community plugins will be listed when available. If you create a Viben plugin, please submit a Pull Request to add it to this list. :::

Create Your Own Plugin​

Interested in creating a plugin? The social media plugin serves as a reference implementation:

backend/plugins/browse-mcp-plugin-social-media/
|-- pyproject.toml # Package configuration with entry points
|-- social_media_searchers/
|-- __init__.py # Package initialization
|-- types.py # SocialPost dataclass
|-- github.py # GitHub searcher
|-- twitter.py # Twitter searcher
|-- zhihu.py # Zhihu searcher
|-- xiaohongshu.py # Xiaohongshu searcher

Key steps to create a plugin:

  1. Define a content type with a to_text() method
  2. Implement ContentSource[T] with search(), download(), and read() methods
  3. Register entry points in pyproject.toml
  4. Publish to PyPI for easy installation

See Plugin Overview for API details.

Plugin Ideas​

Here are some plugin ideas the community could implement:

Documentation Sites​

Potential Data SourceDescription
MDN Web DocsMozilla Developer Network
DevDocsAPI documentation browser
Read the DocsDocumentation hosting platform

News and Blogs​

Potential Data SourceDescription
Hacker NewsTechnology news aggregation
RSS FeedsGeneral RSS reader
MediumBlog platform
Dev.toDeveloper community

Code and Technology​

Potential Data SourceDescription
Stack OverflowDeveloper Q&A
GitLabCode hosting platform
npmJavaScript package repository
PyPIPython Package Index

Other Academic​

Potential Data SourceDescription
DBLPComputer science bibliography
NASA ADSAstrophysics Data System
SSRNSocial science research
PhilPapersPhilosophy research

Submit Your Plugin​

To add your plugin to this list:

  1. Create a GitHub Issue with plugin details
  2. Or submit a Pull Request to edit this page

Listing requirements:

  • Plugin must be published to PyPI
  • Must have documentation or README
  • Must follow Viben plugin conventions
  • Should include tests

Next Steps​