Conan Package README MCP Server

An MCP (Model Context Protocol) server that provides tools to fetch package information, README content, and usage examples from Conan Center.

Features

• Package README retrieval: Get README content and usage examples for Conan packages
• Package information: Fetch basic package info, dependencies, and configuration options
• Package search: Search for packages in Conan Center
• Smart caching: Built-in caching to reduce API calls and improve performance
• Error handling: Comprehensive error handling with detailed error messages

Available Tools

get_readme_from_conan

Get package README and usage examples from Conan Center.

Parameters:

• package_name (required): The name of the Conan package
• version (optional): The version of the package (default: "latest")
• include_examples (optional): Whether to include usage examples (default: true)

get_package_info_from_conan

Get package basic information and dependencies from Conan Center.

Parameters:

• package_name (required): The name of the Conan package
• include_dependencies (optional): Whether to include dependencies (default: true)
• include_options (optional): Whether to include package options (default: false)

search_packages_from_conan

Search for packages in Conan Center.

Parameters:

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

Installation

npm install conan-package-readme-mcp-server

Usage

With Claude Desktop

Add this configuration to your claude_desktop_config.json:

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

Direct Usage

npx conan-package-readme-mcp-server

Examples

Get Package README

{
  "tool": "get_readme_from_conan",
  "arguments": {
    "package_name": "boost",
    "version": "1.82.0",
    "include_examples": true
  }
}

Get Package Information

{
  "tool": "get_package_info_from_conan",
  "arguments": {
    "package_name": "opencv",
    "include_dependencies": true,
    "include_options": true
  }
}

Search Packages

{
  "tool": "search_packages_from_conan",
  "arguments": {
    "query": "json parser",
    "limit": 10
  }
}

Development

Building

npm run build

Testing

npm test

Development Mode

npm run dev

License

MIT

Author

naoto24kawa