CocoaPods Package README MCP Server

A Model Context Protocol (MCP) server for retrieving README files and package information from CocoaPods with comprehensive documentation extraction.

Features

• Package README Retrieval: Get comprehensive README content and usage examples from CocoaPods packages

• Package Information: Fetch detailed package metadata, dependencies, and platform support

• Package Search: Search the CocoaPods registry with filtering capabilities

• Smart Caching: Efficient caching system to reduce API calls

• GitHub Integration: Automatically fetches README content from GitHub repositories

• Swift/iOS Focused: Optimized for iOS development with Swift and Objective-C code examples

Installation

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

Environment Variables

• GITHUB_TOKEN (optional): GitHub personal access token for higher API rate limits

• LOG_LEVEL (optional): Logging level (debug, info, warn, error) - default: info

• CACHE_TTL (optional): Cache TTL in milliseconds - default: 3600000 (1 hour)

• CACHE_MAX_SIZE (optional): Maximum cache entries - default: 1000

• REQUEST_TIMEOUT (optional): HTTP request timeout in milliseconds - default: 30000

Available Tools

get_package_readme

Get package README and usage examples from CocoaPods registry.

Parameters:

• package_name (string, required): The name of the CocoaPods package

• version (string, optional): The version of the package (default: "latest")

• include_examples (boolean, optional): Whether to include usage examples (default: true)

Example:

get_package_info

Get package basic information and dependencies from CocoaPods registry.

Parameters:

• package_name (string, required): The name of the CocoaPods package

• include_dependencies (boolean, optional): Whether to include dependencies (default: true)

• include_dev_dependencies (boolean, optional): Whether to include test dependencies (default: false)

Example:

search_packages

Search for packages in CocoaPods registry.

Parameters:

• query (string, required): The search query

• limit (number, optional): Maximum number of results to return (default: 20, max: 250)

• quality (number, optional): Minimum quality score (0-1)

• popularity (number, optional): Minimum popularity score (0-1)

Example:

Supported Package Examples

• Alamofire: Modern HTTP networking library for Swift

• AFNetworking: Objective-C HTTP networking library

• SwiftyJSON: JSON parsing library for Swift

• SnapKit: Auto Layout DSL for Swift

• Realm: Mobile database framework

• Charts: Beautiful charts library

• Kingfisher: Image downloading and caching library

API Integration

This server integrates with:

• CocoaPods API (https://cocoapods.org/api/v1) for package information and search

• GitHub API for README content retrieval

• Local caching for performance optimization

Development

Setup

Build

Development Server

Testing

Architecture

License

MIT

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request