elchika-inc/cocoapods-package-readme-mcp-server

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

npm install cocoapods-package-readme-mcp-server

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "cocoapods-readme": {
      "command": "node",
      "args": ["path/to/cocoapods-package-readme-mcp-server/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token-here"
      }
    }
  }
}

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:

{
  "package_name": "Alamofire",
  "version": "latest",
  "include_examples": true
}

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:

{
  "package_name": "AFNetworking",
  "include_dependencies": true,
  "include_dev_dependencies": false
}

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:

{
  "query": "networking",
  "limit": 10,
  "quality": 0.5
}

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

git clone <repository-url>
cd cocoapods-package-readme-mcp-server
npm install

Build

npm run build

Development Server

npm run dev

Testing

npm test

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   MCP Client    │───▶│   CocoaPods     │───▶│  CocoaPods API  │
│   (Claude)      │    │  README Server  │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │   GitHub API    │
                       │  (README fetch) │
                       └─────────────────┘

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