This package has been deprecated

Author message:

このパッケージは @elchika-inc/cpan-package-readme-mcp-server に移行しました

cpan-package-readme-mcp-server
TypeScript icon, indicating that this package has built-in type declarations

0.1.2 • Public • Published

CPAN Package README MCP Server

npm version npm downloads GitHub stars GitHub issues license

A Model Context Protocol (MCP) server that provides CPAN (Comprehensive Perl Archive Network) package information, including README content, package metadata, and search capabilities.

Features

  • Package README: Fetch README and documentation for CPAN modules
  • Package Information: Get metadata, dependencies, and version info
  • Search Packages: Search CPAN repository for modules
  • Comprehensive Documentation: Access detailed package information and usage examples

Installation

npm install cpan-package-readme-mcp-server

Usage

As an MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "cpan-package-readme": {
      "command": "npx",
      "args": ["cpan-package-readme-mcp-server"]
    }
  }
}

Available Tools

get_readme_from_cpan

Get package README and usage examples from CPAN.

Parameters:

  • package_name (required): The CPAN module name (e.g., "Data::Dumper", "LWP::UserAgent")
  • version (optional): Package version (defaults to latest)
  • include_examples (optional): Whether to include usage examples (default: true)

Example:

{
  "package_name": "LWP::UserAgent",
  "include_examples": true
}

get_package_info_from_cpan

Get package basic information and dependencies from CPAN.

Parameters:

  • package_name (required): The CPAN module name
  • include_dependencies (optional): Whether to include dependencies (default: true)
  • include_dev_dependencies (optional): Whether to include test dependencies (default: false)

Example:

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

search_packages_from_cpan

Search for packages in CPAN.

Parameters:

  • query (required): The search query
  • limit (optional): Maximum number of results (default: 20, max: 100)

Example:

{
  "query": "web framework",
  "limit": 10
}

Development

Setup

npm install

Build

npm run build

Test

npm test

Development Mode

npm run dev

Configuration

The server uses MetaCPAN API to fetch package information. No additional configuration is required for basic usage.

Error Handling

The server handles various error conditions:

  • Package not found
  • Invalid module names
  • Network connectivity issues
  • Rate limiting
  • Invalid parameters

Dependencies

  • @modelcontextprotocol/sdk: MCP SDK for server implementation
  • Built-in HTTP client for MetaCPAN API requests

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Package Sidebar

Install

npm i cpan-package-readme-mcp-server

Weekly Downloads

11

Version

0.1.2

License

MIT

Unpacked Size

188 kB

Total Files

70

Last publish

Collaborators

  • naoto24kawa