README - Spryker Package Search by vitaliiivanovspryker

Spryker Package Search Tool

A command-line tool that initializes a Model Context Protocol (MCP) server to provide package search capabilities for Spryker GitHub repositories.

This tool allows you to search Spryker packages or their code contents using natural language queries. It supports filtering by specific GitHub organizations.

✨ Features

Search for Spryker packages on GitHub
Code-level search across Spryker repositories
Support for filtering by organization (spryker, spryker-eco, spryker-sdk, spryker-shop)
Runs as an MCP server using stdio transport

🚀 Installation

Ensure npm and npx are installed.

git clone

cd spryker-module-finder && npm install

MCP server makes the tool compatible with various AI agents to extend context with Spryker Project context

Tools:

Settings

You can add as many servers as projects, just by configuring them properly using the project name.

{
  "mcpServers": {
      "sprykerPackageSearch": {
          "command": "npx",
          "args": [
              "-y",
              "/FULL_PATH/spryker-module-finder"
          ],
          "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN":"token"
          }
      }
  }
}

Debug

npx @modelcontextprotocol/inspector npx node src/index.js

Test

npm test

npx eslint . --fix

🧠 Available Tools

search_spryker_packages

Searches for Spryker packages based on a natural language query.

Parameters:

query (string, required): The natural language query to search GitHub repositories.
organisations (array of strings, optional): List of GitHub orgs to filter by. Example: ["spryker", "spryker-eco", "spryker-sdk", "spryker-shop"]

search_spryker_package_code

Searches for PHP code inside Spryker GitHub repositories.

Parameters:

query (string, required): The natural language query to search within code.
organisations (array of strings, optional): List of GitHub orgs to filter by. Example: ["spryker", "spryker-eco", "spryker-sdk", "spryker-shop"]

search_spryker_documentation_path

Searches for Spryker documentation links.

Parameters:

query (string, required): The natural language query to search Spryker documentation links.

🧩 Architecture

Built with Model Context Protocol SDK

Uses StdioServerTransport for communication

Validates input with zod

Handles GitHub API integration for repository and code search

📄 License

👥 Authors

Vitalii Ivanov