{"_id":"@abdokouta/refine-mcp","_rev":"2-cbe950af7ce4429e04a123ed0e9885c4","name":"@abdokouta/refine-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@abdokouta/refine-mcp","version":"0.1.0","keywords":["mcp","refine","react","admin","crud","data-provider","model-context-protocol"],"author":{"name":"Abdo Kouta"},"license":"MIT","_id":"@abdokouta/refine-mcp@0.1.0","maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"homepage":"https://github.com/abdokouta/refine-mcp#readme","bugs":{"url":"https://github.com/abdokouta/refine-mcp/issues"},"bin":{"refine-mcp":"dist/index.js"},"dist":{"shasum":"959669df18277ea1828da38a32856942ab42dcd8","tarball":"https://registry.npmjs.org/@abdokouta/refine-mcp/-/refine-mcp-0.1.0.tgz","fileCount":7,"integrity":"sha512-qdRffxIow9zzIlHWud22JEpL6Fok1sozlm7KoWkXn2q2CHMn802OskSe25QRabOVzmLR3umuW5jIwaFkyu8OMA==","signatures":[{"sig":"MEQCIHF3sgEIzrT6z92VjOgvhKK5ohjwqzRoIneQ2mure4R9AiBhnjP6Cecp8/JApiChzd3uzqp4jQzxFr7AjcMTrA3KsQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30367},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"2e1261d5985d9a41bb9b855b6b6b36060c7ca6dc","scripts":{"dev":"tsc --watch","build":"tsc","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"abdokouta","email":"akouta66@gmail.com"},"repository":{"url":"git+https://github.com/abdokouta/refine-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Refine framework - automatically clones and explores the source code to understand data providers, auth, and routing","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/refine-mcp_0.1.0_1774920957465_0.1777465866410599","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@abdokouta/refine-mcp","version":"0.1.1","description":"MCP server for Refine framework - automatically clones and explores the source code to understand data providers, auth, and routing","type":"module","bin":{"refine-mcp":"dist/index.js"},"scripts":{"build":"tsc","postbuild":"chmod +x dist/index.js","dev":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"keywords":["mcp","refine","react","admin","crud","data-provider","model-context-protocol"],"author":{"name":"Abdo Kouta"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/abdokouta/refine-mcp.git"},"bugs":{"url":"https://github.com/abdokouta/refine-mcp/issues"},"homepage":"https://github.com/abdokouta/refine-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"_id":"@abdokouta/refine-mcp@0.1.1","gitHead":"df323b7a7aab5cbdfa4ac027f6bfc19d2c5353eb","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-yyqETMUCTh60M+h1UF6SfyznL+uOZnI0hNs2q2Kkw98KhGwWOCeelf9R5YXoMh+4sLq1FZsmVY3XUnt8HNzaXg==","shasum":"60a9c9f56090df822d6be71019d4b627c489e3fd","tarball":"https://registry.npmjs.org/@abdokouta/refine-mcp/-/refine-mcp-0.1.1.tgz","fileCount":7,"unpackedSize":30410,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDRci2Sg2j6URtrWyJMLmCtK07pIsGQlxT1eix+gMv/DAiEAi8m4Q8tttA2PkE2+e7w3boCplZzmWCaTrSWOu5Vs9Tc="}]},"_npmUser":{"name":"abdokouta","email":"akouta66@gmail.com"},"directories":{},"maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/refine-mcp_0.1.1_1774921380557_0.10387808080009897"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T01:35:57.384Z","modified":"2026-03-31T01:43:00.826Z","0.1.0":"2026-03-31T01:35:57.623Z","0.1.1":"2026-03-31T01:43:00.726Z"},"bugs":{"url":"https://github.com/abdokouta/refine-mcp/issues"},"author":{"name":"Abdo Kouta"},"license":"MIT","homepage":"https://github.com/abdokouta/refine-mcp#readme","keywords":["mcp","refine","react","admin","crud","data-provider","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/abdokouta/refine-mcp.git"},"description":"MCP server for Refine framework - automatically clones and explores the source code to understand data providers, auth, and routing","maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"readme":"# Refine MCP Server\n\nModel Context Protocol (MCP) server for exploring and understanding the [Refine](https://refine.dev/) framework.\n\n## Features\n\nThis MCP server provides tools for AI assistants to:\n\n- **Explore Structure**: Navigate the Refine codebase directory tree\n- **Read Files**: Access source code files for analysis\n- **Search Files**: Find files by name pattern\n- **Get Packages**: List all packages in the Refine monorepo with metadata\n- **Read Core Files**: Quickly access key implementation files by category (data providers, auth, routing, hooks)\n\n## Auto-Clone Feature\n\nThe server automatically clones the Refine repository on first run if it doesn't exist locally. No manual setup required!\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @abdokouta/refine-mcp\n```\n\n### Local Installation\n\n```bash\nnpm install @abdokouta/refine-mcp\n```\n\n## Usage\n\n### With Kiro IDE\n\nAdd to your `.kiro/settings/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"refine\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abdokouta/refine-mcp@latest\"],\n      \"disabled\": false,\n      \"autoApprove\": [\n        \"explore_structure\",\n        \"read_file\",\n        \"search_files\",\n        \"get_packages\",\n        \"read_core_files\"\n      ]\n    }\n  }\n}\n```\n\n### With Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"refine\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abdokouta/refine-mcp@latest\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### explore_structure\n\nExplore the directory structure of the Refine repository.\n\n**Parameters:**\n- `maxDepth` (optional): Maximum depth to explore (default: 3)\n\n### read_file\n\nRead the content of a specific file.\n\n**Parameters:**\n- `path` (required): Relative path from refine-source root\n\n**Example:**\n```typescript\n{\n  \"path\": \"packages/core/src/index.ts\"\n}\n```\n\n### search_files\n\nSearch for files by name pattern.\n\n**Parameters:**\n- `pattern` (required): File name pattern to search for\n\n**Example:**\n```typescript\n{\n  \"pattern\": \"provider\"\n}\n```\n\n### get_packages\n\nGet information about all packages in the Refine monorepo.\n\n**Parameters:** None\n\n### read_core_files\n\nRead multiple core implementation files at once.\n\n**Parameters:**\n- `category` (required): One of \"data-provider\", \"auth-provider\", \"router\", \"hooks\", \"core\", or \"all\"\n\n**Example:**\n```typescript\n{\n  \"category\": \"data-provider\"\n}\n```\n\n## Environment Variables\n\n- `REFINE_SOURCE_PATH`: Custom path for the Refine repository (optional, defaults to auto-clone location)\n\n## Use Cases\n\n### Understanding Data Providers\n\n```\n\"How do Refine data providers work? Show me the core implementation.\"\n```\n\nThe MCP will read the data provider interface and example implementations.\n\n### Debugging Auth Issues\n\n```\n\"I'm having issues with authentication in Refine. Can you show me how auth providers are structured?\"\n```\n\n### Learning Refine Hooks\n\n```\n\"Show me how useList and useOne hooks work in Refine\"\n```\n\n## Repository\n\nThe server clones from: https://github.com/refinedev/refine\n\n## License\n\nMIT\n\n## Author\n\nAbdo Kouta\n","readmeFilename":"README.md"}