{"_id":"@aki77/find-agents-md","name":"@aki77/find-agents-md","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aki77/find-agents-md","version":"1.0.0","description":"MCP server to find AGENTS.md and CLAUDE.md files with references","type":"module","main":"dist/index.js","bin":{"find-agents-md":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","prepare":"npm run build","test":"npm run build && node --test dist/**/*.test.js"},"keywords":["mcp","agents","claude","ai","markdown"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^4.1.12"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"packageManager":"pnpm@10.18.2+sha512.9fb969fa749b3ade6035e0f109f0b8a60b5d08a1a87fdf72e337da90dcc93336e2280ca4e44f2358a649b83c17959e9993e777c2080879f3801e6f0d999ad3dd","volta":{"node":"22.20.0"},"_id":"@aki77/find-agents-md@1.0.0","gitHead":"f58a52903a0d1f1970d462ae3f85e2c95e87ca40","types":"./dist/index.d.ts","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-KQBPPhj7nfCzXbQ9tdu9EuLJ6iry5ZcS/3/CT8upsqg+igGLIvPADoZggCLU2Yn2v3/PRXscd8S71vXaLZ1T6A==","shasum":"89a59aa9161271996a01ae44e72c8536e6c3d499","tarball":"https://registry.npmjs.org/@aki77/find-agents-md/-/find-agents-md-1.0.0.tgz","fileCount":39,"unpackedSize":65759,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDx1xShvgDn7uZw/XRpOmxSGXHxpJSv1rgGN2anSgyiJAIhALx6mSV5qQ6lYaD21K0Bgtnq4zWuk7IXN+yKZAqkNyN1"}]},"_npmUser":{"name":"aki77","email":"lala.akira+npm@gmail.com"},"directories":{},"maintainers":[{"name":"aki77","email":"lala.akira+npm@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/find-agents-md_1.0.0_1760157064267_0.5949836009533416"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-11T04:31:04.074Z","1.0.0":"2025-10-11T04:31:04.480Z","modified":"2025-10-11T04:31:04.845Z"},"maintainers":[{"name":"aki77","email":"lala.akira+npm@gmail.com"}],"description":"MCP server to find AGENTS.md and CLAUDE.md files with references","keywords":["mcp","agents","claude","ai","markdown"],"license":"MIT","readme":"# find-agents-md\n\nA tool implemented as an MCP server to search for AGENTS.md and CLAUDE.md files.\n\n## Overview\n\nThis tool traverses from a specified file's directory up to the project root (where the `.git` directory exists) and collects the following files:\n\n- `AGENTS.md` - AI agent instruction file compliant with the [agents.md](https://agents.md/) specification\n- `CLAUDE.md` - Claude-specific project instruction file\n- Files referenced within the above files (via markdown links)\n\n## Features\n\n- **Directory Traversal**: Searches upward from the target file through parent directories\n- **Project Root Detection**: Automatically detects project root by locating the `.git` directory\n- **Reference Resolution**: Resolves markdown links `[text](path)` and `[@project-path](path)`\n  - Relative paths: Resolved as relative paths from the file\n  - Project root relative: Resolved from project root using `[@path/to/file](...)` format\n\n## Usage\n\n### As an MCP Server\n\nAdd to your Claude Desktop or other MCP client configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"find-agents-md\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aki77/find-agents-md\"]\n    }\n  }\n}\n```\n\n### Using the Tool\n\nCall the `find_agents_md` tool from your MCP client:\n\n```typescript\n{\n  \"name\": \"find_agents_md\",\n  \"arguments\": {\n    \"filePath\": \"/path/to/your/project/src/file.ts\"\n  }\n}\n```\n\n### Output Format\n\nThe tool returns results in the following format:\n\n**Text format**:\n```\nFound 3 file(s): 1 AGENTS.md, 1 CLAUDE.md, 1 reference\n```\n\n**Structured data** (`_meta` field):\n```json\n{\n  \"files\": [\n    {\n      \"path\": \"/absolute/path/to/AGENTS.md\",\n      \"type\": \"agents\",\n      \"content\": \"...\"\n    },\n    {\n      \"path\": \"/absolute/path/to/CLAUDE.md\",\n      \"type\": \"claude\",\n      \"content\": \"...\"\n    },\n    {\n      \"path\": \"/absolute/path/to/referenced.md\",\n      \"type\": \"reference\",\n      \"content\": \"...\"\n    }\n  ]\n}\n```\n\n## Development\n\n```bash\n# Build\npnpm run build\n\n# Development mode (watch mode)\npnpm run dev\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-a140cdfd4bdb67e110719931c969cb51"}