{"id":48582521,"url":"https://github.com/zircote/nsip-plugin","last_synced_at":"2026-04-08T17:34:11.179Z","repository":{"id":333059377,"uuid":"1136077288","full_name":"zircote/nsip-plugin","owner":"zircote","description":"Claude Code plugin for NSIP (National Sheep Improvement Program) sheep breeding data with MCP tools, expert shepherd agent, and intelligent hooks","archived":false,"fork":false,"pushed_at":"2026-02-27T22:57:02.000Z","size":190,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T03:45:57.938Z","etag":null,"topics":["breeding","claude-code","claude-code-plugin","genetics","livestock","mcp","nsip","sheep"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zircote.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"zircote"}},"created_at":"2026-01-17T02:56:42.000Z","updated_at":"2026-02-27T22:56:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zircote/nsip-plugin","commit_stats":null,"previous_names":["zircote/nsip"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zircote/nsip-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zircote%2Fnsip-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zircote%2Fnsip-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zircote%2Fnsip-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zircote%2Fnsip-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zircote","download_url":"https://codeload.github.com/zircote/nsip-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zircote%2Fnsip-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31567056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["breeding","claude-code","claude-code-plugin","genetics","livestock","mcp","nsip","sheep"],"created_at":"2026-04-08T17:34:10.372Z","updated_at":"2026-04-08T17:34:11.148Z","avatar_url":"https://github.com/zircote.png","language":"Python","funding_links":["https://github.com/sponsors/zircote"],"categories":[],"sub_categories":[],"readme":"# NSIP Plugin\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://github.com/anthropics/claude-code)\n[![CI](https://github.com/zircote/nsip/actions/workflows/ci.yml/badge.svg)](https://github.com/zircote/nsip/actions/workflows/ci.yml)\n[![Version](https://img.shields.io/badge/version-1.4.5-green.svg)](https://github.com/zircote/nsip/releases)\n\nAccess NSIP (National Sheep Improvement Program) sheep breeding data through Claude Code with one-command installation.\n\n## Features\n\n- **9 MCP tools** for sheep breeding data access\n- **10 slash commands** for quick workflows\n- **1 expert agent** (shepherd) for breeding consultation\n- **14 automatic hooks** for enhanced functionality\n- Automatic package installation via `uvx`\n- No manual setup required\n\n## Installation\n\n### From GitHub\n\n```bash\nclaude plugin install zircote/nsip\n```\n\n### Manual Installation\n\nClone and add to Claude Code:\n\n```bash\ngit clone https://github.com/zircote/nsip.git\nclaude --plugin-dir /path/to/nsip\n```\n\n## Verify Installation\n\nAfter installing, verify the MCP tools and commands are working:\n\n```bash\n# Test API connectivity\n/nsip:test-api\n\n# Get database info (should show last update date)\n/nsip:discover\n\n# Verify MCP tools are available\n\"Use nsip_list_breeds to show available sheep breeds\"\n```\n\n## Commands\n\n| Command | Purpose | Example |\n|---------|---------|---------|\n| `/nsip:consult` | Expert breeding consultation (uses shepherd agent) | `/nsip:consult I need a terminal sire` |\n| `/nsip:discover` | Show database info, breeds, statuses | `/nsip:discover` |\n| `/nsip:lookup` | Get animal details by LPN ID | `/nsip:lookup 6####92020###249` |\n| `/nsip:profile` | Complete animal profile | `/nsip:profile 6####92020###249` |\n| `/nsip:health` | Server performance metrics | `/nsip:health` |\n| `/nsip:test-api` | Validate API connectivity | `/nsip:test-api` |\n| `/nsip:search` | Search animals with filters | `/nsip:search` |\n| `/nsip:traits` | Get trait ranges for breed | `/nsip:traits 486` |\n| `/nsip:lineage` | Get pedigree tree | `/nsip:lineage 6####92020###249` |\n| `/nsip:progeny` | List offspring | `/nsip:progeny 6####92020###249` |\n\n## Expert Agent\n\n**`/nsip:consult`** invokes the `nsip:shepherd` expert agent, which provides:\n- Breeding decision support with NSIP data analysis\n- Health diagnosis and treatment recommendations\n- Nutrition planning across production stages\n- Flock management and culling guidance\n- Genetic trait interpretation and selection strategies\n\n## MCP Tools\n\nAsk Claude to use these tools directly:\n\n- `nsip_get_last_update`: Database update date\n- `nsip_list_breeds`: Available breed groups\n- `nsip_get_statuses`: Animal statuses by breed\n- `nsip_get_trait_ranges`: Trait ranges for breed\n- `nsip_search_animals`: Search with pagination\n- `nsip_get_animal`: Detailed animal information\n- `nsip_get_lineage`: Pedigree tree\n- `nsip_get_progeny`: Offspring list\n- `nsip_search_by_lpn`: Complete animal profile\n\n## Enhanced Features (Hooks)\n\nThe plugin includes 14 intelligent hooks that automatically enhance your workflow:\n\n### Hook Categories\n\n**Error Resilience (3 hooks)**\n- Auto-retry with exponential backoff\n- Fallback to cached data on failures\n- Alert tracking for repeated errors\n\n**Context Enhancement (2 hooks)**\n- Breed-specific characteristics injection\n- Comprehensive trait definitions\n\n**Data Export (2 hooks)**\n- Pedigree tree visualizations\n- Breeding analysis reports\n\n**Workflow Intelligence (2 hooks)**\n- Smart LPN ID detection in prompts\n- Comparative analysis suggestions\n\n**Core Operations (5 hooks)**\n- API health monitoring\n- LPN format validation\n- Query logging\n- Result caching\n- CSV exports\n\nSee [hooks/README.md](./hooks/README.md) for detailed documentation.\n\n## Hook Data Locations\n\n**Logs**: `~/.claude-code/nsip-logs/`\n**Cache**: `~/.claude-code/nsip-cache/` (60-min TTL)\n**Exports**: `~/.claude-code/nsip-exports/`\n\n## File Structure\n\n```\nnsip/\n├── .claude-plugin/\n│   └── plugin.json\n├── agents/\n│   └── shepherd.md\n├── commands/\n│   ├── consult.md\n│   ├── discover.md\n│   ├── health.md\n│   ├── lineage.md\n│   ├── lookup.md\n│   ├── profile.md\n│   ├── progeny.md\n│   ├── search.md\n│   ├── test-api.md\n│   └── traits.md\n├── hooks/\n│   ├── hooks.json\n│   ├── README.md\n│   └── scripts/\n│       ├── api_health_check.py\n│       ├── auto_retry.py\n│       ├── breed_context_injector.py\n│       ├── breeding_report.py\n│       ├── comparative_analyzer.py\n│       ├── csv_exporter.py\n│       ├── error_notifier.py\n│       ├── fallback_cache.py\n│       ├── lpn_validator.py\n│       ├── pedigree_visualizer.py\n│       ├── query_logger.py\n│       ├── result_cache.py\n│       ├── smart_search_detector.py\n│       └── trait_dictionary.py\n├── tests/\n│   ├── unit/\n│   ├── integration/\n│   └── fixtures/\n├── nsip.mcp.json\n├── CHANGELOG.md\n├── LICENSE\n└── README.md\n```\n\n## Prerequisites\n\n- Claude Code CLI or VS Code extension\n- `uv` package manager (install from https://docs.astral.sh/uv/)\n- Internet connection (for first-time package download)\n\n## How It Works\n\nThe plugin uses `uvx` to automatically install the `nsip-client` package from GitHub:\n\n1. Claude Code reads `.claude-plugin/plugin.json`\n2. Finds the MCP server configuration\n3. Runs: `uvx --from git+https://github.com/epicpast/nsip-api-client.git nsip-mcp-server`\n4. MCP server starts and connects\n5. All tools become available\n6. Hooks automatically activate\n\n## Troubleshooting\n\n### MCP Server Doesn't Connect\n\n1. **Check uv installation:**\n   ```bash\n   uv --version\n   uvx --version\n   ```\n\n2. **Test the MCP server command manually:**\n   ```bash\n   uvx --from git+https://github.com/epicpast/nsip-api-client.git nsip-mcp-server\n   ```\n\n3. **Re-enable the plugin:**\n   ```bash\n   claude /plugin disable nsip\n   claude /plugin enable nsip\n   ```\n\n### API Connection Errors\n\nThe NSIP API is public and requires no authentication.\n\n```bash\n# Test API directly\ncurl http://nsipsearch.nsip.org/api/GetLastUpdate\n```\n\n## Platform Support\n\nWorks identically on:\n- Claude Code CLI (terminal)\n- Claude Code VS Code extension\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Support\n\n- **MCP Client Repository**: https://github.com/epicpast/nsip-api-client\n- **Hook Documentation**: [hooks/README.md](./hooks/README.md)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzircote%2Fnsip-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzircote%2Fnsip-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzircote%2Fnsip-plugin/lists"}