MCP工具

Install dependencies (use pnpm, npm, or yarn)

pnpm install # or: npm install

Dependencies

npm run deps:update # Update dependencies npm run deps:audit # Audit for security issues ```

Run integration tests (requires internet connection)

npm run test:integration ```

What's tested: - All public tools (search_posts, get_user_profile, get_followers, get_follows, get_thread, get_custom_feed) - DID and handle resolution - Pagination support - Error handling - AT Protocol specification compliance - Rate limiting behavior

Note: Integration tests are opt-in and disabled by default to avoid hitting real servers during normal development. See Integration Tests Documentation for details.

Installation

npm install -g atproto-mcp

Or use with npx:

npx atproto-mcp

Build for production

pnpm build # or: npm run build ```

Production Deployment

The AT Protocol MCP Server is production-ready with comprehensive features for enterprise deployment:

Docker Deployment

```bash

Quick start with Docker Compose

docker-compose up -d

Or build and run manually

docker build -t atproto-mcp . docker run -d -p 3000:3000 \ -e ATPROTO_IDENTIFIER=your.handle \ -e ATPROTO_PASSWORD=your-password \ atproto-mcp ```

Quick Start

Option 1: Unauthenticated Mode (Recommended for most use cases)

Perfect for LLM clients that need to access public AT Protocol data:

1. Configure your LLM client (e.g., Claude Desktop) to launch the MCP server:

Add to your LLM client's MCP configuration:

   {
     "mcpServers": {
       "atproto": {
         "command": "npx",
         "args": ["atproto-mcp"]
       }
     }
   }
   

1. Start your LLM client - it will automatically launch the MCP server

1. Interact in natural language - Ask your LLM to search posts, view profiles, etc.

What your LLM can do in unauthenticated mode: - View user profiles (get_user_profile - works without auth, provides additional viewer-specific data when authenticated) - Manage OAuth authentication flows (start_oauth_flow, handle_oauth_callback, refresh_oauth_tokens, revoke_oauth_tokens)

Note: The following features require authentication: - Searching posts and hashtags (search_posts) - API changed in 2025 to require authentication - Viewing follower/following lists (get_followers, get_follows) - Browsing feeds and threads (get_thread, get_custom_feed, get_timeline) - All write operations (create, like, repost, follow, etc.) - Resources (timeline, profile, notifications) - these are listed but will return an error when accessed without authentication - Prompts (content composition, reply templates) - these are listed but will return an error when accessed without authentication

Important: All tools, resources, and prompts are listed by the MCP server regardless of authentication state. Tools and resources that require authentication will return a clear error message when called without proper credentials.

Quick Start

```bash

Copy example environment file

cp .env.example .env

Option 2: Authenticated Mode (For full functionality)

Enable write operations and private data access for your LLM:

1. Configure your LLM client with AT Protocol credentials:

   {
     "mcpServers": {
       "atproto": {
         "command": "npx",
         "args": ["atproto-mcp"],
         "env": {
           "ATPROTO_IDENTIFIER": "your-handle.bsky.social",
           "ATPROTO_PASSWORD": "your-app-password"
         }
       }
     }
   }
   

1. Start your LLM client - it will launch the authenticated MCP server

What your LLM can do in authenticated mode: - Create, edit, and delete posts - Follow/unfollow users - Like and repost content - Access personalized timelines and notifications - Manage lists and moderation settings

Authentication (Optional)

The server works perfectly without authentication for accessing public data. Authentication is only needed for write operations and private data access.

Environment Configuration

```bash

Integration Tests (connects to real AT Protocol servers)

npm run test:integration

npm run lint # Run ESLint npm run lint:fix # Fix linting issues npm run format # Format code with Prettier npm run type-check # Run TypeScript type checking npm run check # Run all quality checks

Integration Tests

Comprehensive integration tests that connect to real AT Protocol servers to validate all public-facing functionality:

```bash