{"id":27867709,"url":"https://github.com/promptmixerdev/usekeen-mcp","last_synced_at":"2025-09-14T03:10:25.652Z","repository":{"id":289568243,"uuid":"971640835","full_name":"PromptMixerDev/usekeen-mcp","owner":"PromptMixerDev","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-01T00:37:42.000Z","size":42,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-11T15:27:25.538Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PromptMixerDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-23T20:42:40.000Z","updated_at":"2025-04-24T00:03:17.000Z","dependencies_parsed_at":"2025-04-24T00:20:56.633Z","dependency_job_id":"7a4aac05-11fb-4745-899e-2faf5c0f16bf","html_url":"https://github.com/PromptMixerDev/usekeen-mcp","commit_stats":null,"previous_names":["promptmixerdev/usekeen-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PromptMixerDev/usekeen-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PromptMixerDev%2Fusekeen-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PromptMixerDev%2Fusekeen-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PromptMixerDev%2Fusekeen-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PromptMixerDev%2Fusekeen-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PromptMixerDev","download_url":"https://codeload.github.com/PromptMixerDev/usekeen-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PromptMixerDev%2Fusekeen-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275055387,"owners_count":25397654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-04T22:52:37.082Z","updated_at":"2025-09-14T03:10:25.634Z","avatar_url":"https://github.com/PromptMixerDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UseKeen Documentation MCP Server\n\nMCP Server for the UseKeen Package Documentation Search API, enabling Claude and other AI assistants to search for documentation of packages and services.\n\n## Tools\n\n1. `usekeen_package_doc_search`\n   - Search documentation of packages and services to find implementation details, examples, and specifications\n   - Required inputs:\n     - `package_name` (string): Name of the package or service to search documentation for (e.g. 'react', 'aws-s3', 'docker')\n   - Optional inputs:\n     - `query` (string): Search term to find specific information within the package/service documentation (e.g. 'file upload example', 'authentication methods')\n   - Returns: Documentation search results with relevant matches, URLs, and snippets\n\n## Setup\n\n1. Get a UseKeen API key from the UseKeen service\n2. Set up the environment with your API key as shown below\n\n## Usage with Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n#### NPX\n\n```json\n{\n  \"mcpServers\": {\n    \"usekeen\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@modelcontextprotocol/server-usekeen\"\n      ],\n      \"env\": {\n        \"USEKEEN_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"usekeen\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"USEKEEN_API_KEY\",\n        \"mcp/usekeen\"\n      ],\n      \"env\": {\n        \"USEKEEN_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Usage with VS Code\n\nFor manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open Settings (JSON)`.\n\nOptionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.\n\n\u003e Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.\n\n#### NPX\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"usekeen_api_key\",\n        \"description\": \"UseKeen API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"usekeen\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@modelcontextprotocol/server-usekeen\"],\n        \"env\": {\n          \"USEKEEN_API_KEY\": \"${input:usekeen_api_key}\"\n        }\n      }\n    }\n  }\n}\n```\n\n#### Docker\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"usekeen_api_key\",\n        \"description\": \"UseKeen API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"usekeen\": {\n        \"command\": \"docker\",\n        \"args\": [\"run\", \"-i\", \"--rm\", \"mcp/usekeen\"],\n        \"env\": {\n          \"USEKEEN_API_KEY\": \"${input:usekeen_api_key}\"\n        }\n      }\n    }\n  }\n}\n```\n\n### Manual Setup\n\n#### Using the Helper Scripts\n\nWe provide two helper scripts to make it easier to run the server:\n\n1. **Local Execution**:\n   ```bash\n   # Make the script executable (first time only)\n   chmod +x run-local.sh\n   \n   # Run the server locally\n   ./run-local.sh\n   ```\n\n2. **Docker Execution**:\n   ```bash\n   # Make the script executable (first time only)\n   chmod +x run-docker.sh\n   \n   # Run the server in Docker\n   ./run-docker.sh\n   ```\n\nBoth scripts will check for a `.env` file containing your `USEKEEN_API_KEY`. You can create this file based on the provided `.env.example`.\n\n#### Running with npm\n\nSet the `USEKEEN_API_KEY` environment variable and run the server:\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the TypeScript code\nnpm run build\n\n# Run the server\nUSEKEEN_API_KEY=your_api_key npm start\n```\n\n#### Running with Docker\n\nBuild and run the Docker container with the API key:\n\n```bash\n# Build the Docker image\ndocker build -t mcp/usekeen .\n\n# Run the container\ndocker run -e USEKEEN_API_KEY=your_api_key mcp/usekeen\n```\n\n### Environment Variables\n\n- `USEKEEN_API_KEY`: Required. Your UseKeen API key for authentication.\n\n### Troubleshooting\n\nIf you encounter errors, verify that:\n1. Your UseKeen API key is valid and correctly set in your configuration\n2. You have an active internet connection to reach the UseKeen API\n3. The UseKeen service is currently available\n\n## Build\n\nDocker build:\n\n```bash\ndocker build -t mcp/usekeen .\n```\n\n## License\n\nThis MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpromptmixerdev%2Fusekeen-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpromptmixerdev%2Fusekeen-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpromptmixerdev%2Fusekeen-mcp/lists"}