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