Skip to content

spryker-community/package-search-mcp

Repository files navigation

Spryker Search Tool

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

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


✨ Features

  • Search for Spryker packages on GitHub
  • Search for Spryker public documentation https://docs.spryker.com/
  • Code-level search across Spryker repositories
  • Support for filtering by organization (spryker, spryker-eco, spryker-sdk, spryker-shop, spryker-community)
  • Runs as an MCP server using stdio transport

Example with Claude

https://5ire.app/

Example with Claude for docs

🚀 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", "spryker-community"]

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", "spryker-community"]

search_spryker_documentation

Searches for Spryker documentation.

Parameters:

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

🧩 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

MIT

👥 Authors

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •