Spryker Search Tool
Search Spryker packages, documentation, and code within Spryker GitHub repositories using natural language.
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
🚀 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:
- Claude desktop
- JetBrains AI Assistant plugin
- Qodo Gen JetBrains plugin
- Windsurf
- Cursor
- Cursor
- etc.
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
- Vitalii Ivanov
Related Servers
YouTube Music MCP
Search and play tracks on YouTube Music via AI assistants.
News Fact-Checker
Automated fact-checking of news headlines using web search and Google Gemini AI.
Hacker News
Search for stories, get user information, and interact with Hacker News.
SelfMemory
Let your memories live forever by passing your knowledge to the next generation with SelfMemory.
Gemini MCP
Integrate search grounded Gemini output into your workflow.
YouTube MCP Server
Search YouTube videos, retrieve transcripts, and perform semantic search over video content.
Web Search
A server that provides web search capabilities using OpenAI models.
OpenStreetMap
Enhances LLMs with location-based services and geospatial data from OpenStreetMap.
Haloscan
Interact with the Haloscan SEO API for search engine optimization tasks.
Gemini DeepSearch MCP
An automated research agent using Google Gemini models and Google Search to perform deep, multi-step web research.