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