Changelog

Complete changelog for the ActivityPub MCP Server. Track all releases, new features, improvements, bug fixes, and breaking changes.

Release Notes

All notable changes to the ActivityPub MCP Server are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

v1.0.0 - 2025-01-15

Stable Release

Added

  • Initial stable release of ActivityPub MCP Server
  • Complete MCP (Model Context Protocol) implementation
  • ActivityPub actor discovery and information retrieval
  • Fediverse instance discovery and metadata collection
  • WebFinger protocol support for actor resolution
  • Comprehensive caching system with configurable TTL
  • Rate limiting and request throttling
  • Health check and server monitoring tools
  • Complete TypeScript implementation with type safety
  • Comprehensive error handling and logging

Tools

  • discover-actor - Find and analyze fediverse actors
  • discover-instances - Search for instances by topic or keyword
  • get-instance-info - Retrieve detailed instance information
  • fetch-timeline - Get recent posts from actor timelines
  • search-content - Search for content across the fediverse
  • get-post-details - Retrieve detailed post information
  • health-check - Monitor server health and performance
  • clear-cache - Clear cached data for fresh requests
  • validate-actor - Verify actor accessibility and validity

Resources

  • activitypub://server-info - Server status and configuration
  • activitypub://actor-cache - Cached actor information
  • activitypub://instance-cache - Cached instance data
  • activitypub://timeline-cache - Cached timeline content
  • activitypub://instance-directory - Instance discovery data
  • activitypub://discovery-stats - Discovery operation statistics

Security

  • Input validation and sanitization for all user inputs
  • Rate limiting to prevent abuse and DoS attacks
  • Secure HTTP client configuration with timeout limits
  • Privacy-focused design - only accesses public data
  • Comprehensive error handling to prevent information leakage
  • Configurable user agent and request headers

⚡ Performance

  • Multi-level caching with configurable TTL values
  • Concurrent request handling with connection pooling
  • Optimized JSON parsing and data transformation
  • Memory-efficient data structures and algorithms
  • Configurable request timeouts and retry logic
  • Performance monitoring and metrics collection

v0.9.0 - 2025-01-10

Beta Release

Added

  • Beta release with core functionality
  • Basic MCP protocol implementation
  • ActivityPub actor discovery
  • Instance information retrieval
  • Simple caching mechanism
  • Basic error handling

Changed

  • Improved error messages and logging
  • Enhanced cache performance
  • Better TypeScript type definitions
  • Optimized HTTP request handling

Fixed

  • Fixed memory leaks in cache implementation
  • Resolved timeout issues with slow instances
  • Fixed JSON parsing errors for malformed responses
  • Corrected WebFinger resolution edge cases

v0.5.0 - 2025-01-05

Alpha Release

Added

  • Initial alpha release
  • Basic actor discovery functionality
  • Simple instance information retrieval
  • Proof-of-concept MCP integration
  • Basic TypeScript implementation

Known Issues

  • Limited error handling
  • No caching implementation
  • Basic rate limiting only
  • Limited instance compatibility

Upcoming Features

v1.1.0 - Planned

  • Enhanced search capabilities with filters
  • Support for additional fediverse platforms (PeerTube, Pixelfed)
  • Advanced analytics and trend detection
  • Improved caching strategies and persistence
  • WebSocket support for real-time updates
  • Plugin system for extensibility

v1.2.0 - Future

  • Machine learning integration for content analysis
  • Advanced federation graph analysis
  • Content recommendation algorithms
  • Multi-language support and i18n
  • Advanced privacy controls and GDPR compliance tools
  • Integration with additional AI/ML platforms

Release Statistics

Total Releases

3

Including alpha, beta, and stable releases

Features Added

25+

Major features and capabilities

Tools Available

9

MCP tools for fediverse exploration

Resources Provided

6

MCP resources for data access

Migration Guides

Upgrading to v1.0.0

No breaking changes from v0.9.0. Simply update your package:

npm update activitypub-mcp

All existing configurations and integrations remain compatible.

Upgrading from v0.5.0

Significant changes in configuration and API:

  • Update environment variable names (see configuration guide)
  • Review cache settings - new TTL options available
  • Update any custom error handling code
  • Test all integrations thoroughly

🤝 Contributing

We welcome contributions to the ActivityPub MCP Server! Here's how you can help:

Bug Reports

Found a bug? Please report it on our GitHub issues page with:

  • Detailed description of the issue
  • Steps to reproduce
  • Expected vs actual behavior
  • Environment information

Feature Requests

Have an idea for a new feature? We'd love to hear it:

  • Describe the feature and its benefits
  • Provide use cases and examples
  • Consider implementation complexity
  • Check existing issues first

Code Contributions

Ready to contribute code? Follow our guidelines:

  • Fork the repository and create a feature branch
  • Follow our coding standards and conventions
  • Add tests for new functionality
  • Update documentation as needed

Related Resources

Setup Guide

Get started with the latest version

API Reference

Complete documentation for all tools and resources

Troubleshooting

Solutions for common issues and problems