# ActivityPub MCP Server

> A comprehensive Model Context Protocol (MCP) server that enables LLMs like Claude to explore and interact with the existing Fediverse through standardized MCP tools, resources, and prompts.

## Overview

The ActivityPub MCP Server is a Fediverse client that allows AI assistants to discover actors, fetch timelines, explore instances, and search content across the decentralized social web. It implements the complete MCP specification with resources for data access, tools for interaction, and prompts for guided exploration.

### Key Features

- **Fediverse Integration**: Connect to any ActivityPub server (Mastodon, Pleroma, Misskey, etc.)
- **WebFinger Discovery**: Find and resolve actors across the network
- **MCP Protocol**: Full implementation with resources, tools, and prompts
- **TypeScript Implementation**: Modern, type-safe codebase with ESM support
- **Cross-Platform Support**: Works on Windows, macOS, and Linux
- **LLM-Optimized**: Designed for efficient AI assistant interaction
- **Security**: Built-in security scanning and dependency auditing
- **Performance**: Comprehensive logging, caching, and monitoring

## Quick Start

```bash
# Install via npm
npm install -g activitypub-mcp

# Or use with npx
npx activitypub-mcp

# Verify installation
activitypub-mcp --version
```

### Claude Desktop Integration

Add to your Claude Desktop configuration:

```json
{
  "mcpServers": {
    "activitypub": {
      "command": "npx",
      "args": ["-y", "activitypub-mcp"]
    }
  }
}
```

## Documentation

### Setup & Installation

- [Installation Guide](https://cameronrye.github.io/activitypub-mcp/docs/setup/): Complete setup instructions
- [Claude Desktop Integration](https://cameronrye.github.io/activitypub-mcp/docs/setup/claude-desktop/): Configure with Claude Desktop
- [Cross-Platform Setup](https://cameronrye.github.io/activitypub-mcp/docs/setup/cross-platform/): Platform-specific installation
- [Configuration Guide](https://cameronrye.github.io/activitypub-mcp/docs/setup/config-guide/): Environment variables and options

## API Reference

- [MCP Tools](https://cameronrye.github.io/activitypub-mcp/docs/api/tools/): Interactive tools for fediverse discovery and content fetching
- [MCP Resources](https://cameronrye.github.io/activitypub-mcp/docs/api/resources/): Read-only access to remote ActivityPub data
- [MCP Prompts](https://cameronrye.github.io/activitypub-mcp/docs/api/prompts/): Templates for fediverse exploration and discovery

## Guides & Examples

- [Basic Usage](https://cameronrye.github.io/activitypub-mcp/docs/guides/basic-usage/): Getting started with the MCP server
- [Usage Guide](https://cameronrye.github.io/activitypub-mcp/docs/guides/usage-guide/): Comprehensive usage documentation
- [Examples](https://cameronrye.github.io/activitypub-mcp/docs/guides/examples/): Practical examples and integration patterns
- [Real-World Scenarios](https://cameronrye.github.io/activitypub-mcp/docs/guides/real-world-test-scenario/): Testing with actual fediverse instances

## Development

- [Performance Monitoring](https://cameronrye.github.io/activitypub-mcp/docs/development/performance-monitoring/): Built-in logging and metrics
- [Dependency Management](https://cameronrye.github.io/activitypub-mcp/docs/development/dependency-management/): Managing project dependencies
- [Security Audit](https://cameronrye.github.io/activitypub-mcp/docs/development/security-audit-checklist/): Security best practices and audit checklist

## Specifications

- [ActivityPub LLM Guide](https://cameronrye.github.io/activitypub-mcp/docs/specifications/activitypub-llm-specification-guide/): Understanding ActivityPub for LLM integration

## Project Resources

- [GitHub Repository](https://github.com/cameronrye/activitypub-mcp): Source code and issue tracking
- [npm Package](https://www.npmjs.com/package/activitypub-mcp): Install via npm
- [Documentation Site](https://cameronrye.github.io/activitypub-mcp/): Complete documentation
- [Changelog](https://cameronrye.github.io/activitypub-mcp/docs/changelog/): Version history and updates

## Additional Resources

### Troubleshooting & Support

- [Troubleshooting Guide](https://cameronrye.github.io/activitypub-mcp/docs/troubleshooting/): Common issues and solutions
- [GitHub Issues](https://github.com/cameronrye/activitypub-mcp/issues): Report bugs and request features
- [GitHub Discussions](https://github.com/cameronrye/activitypub-mcp/discussions): Community support

### External Documentation

- [ActivityPub Specification](https://www.w3.org/TR/activitypub/): W3C ActivityPub protocol specification
- [Model Context Protocol](https://modelcontextprotocol.io/): MCP specification and documentation
- [Fedify Documentation](https://fedify.dev/): ActivityPub server framework
- [Fediverse Info](https://fediverse.info/): General information about the Fediverse

### Complete Documentation

For comprehensive documentation including detailed API reference, examples, troubleshooting, and specifications, see:
- [llms-full.txt](https://cameronrye.github.io/activitypub-mcp/llms-full.txt): Complete documentation for LLMs

---

**Version:** 1.0.2
**License:** MIT
**Maintainer:** Cameron Rye (https://rye.dev/)
**Repository:** https://github.com/cameronrye/activitypub-mcp