Skip to content
Back to search

pudu

Model Context Protocol (MCP) server connecting AI assistants to the NAHPU ecosystem (WIP)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nahpu--pudu/badge.svg)](/listings/nahpu--pudu)

HTML

<a href="/listings/nahpu--pudu"><img src="/api/listings/nahpu--pudu/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines
  1. # pudu
  2. _Protocol for Unified Data Utilities_
  3. A Model Context Protocol (MCP) server for the [NAHPU](https://github.com/nahpu) ecosystem.
  4. Pudu connects AI assistants to discover NAHPU features, troubleshoot issues, generate document templates, configure data exports, and interact with scientific data workflows using natural language.
  5. ## Etymology
  6. Named after [pudu (_Pudu puda_)](https://www.mammaldiversity.org/taxon/1006305/), one of the world's smallest deer native to southern Chile and southwestern Argentina. Pudu follows the NAHPU ecosystem's naming tradition.
  7. ## Overview
  8. Pudu serves as an integration layer between MCP-compatible clients and the NAHPU ecosystem. It is designed to operate independently of the NAHPU application, providing access to tools and resources without requiring a running NAHPU installation.
  9. Pudu does not provide its own large language model or depend on a specific AI provider.
  10. ## Features
  11. Planned capabilities include:
  12. - **Documentation** — Search NAHPU documentation, discover features, and retrieve usage instructions.
  13. - **Issue tracking** — Search known issues, feature requests, release notes, and potential solutions.
  14. - **Document templates** — Generate and validate specimen tags, labels, catalogs, and other collection documents.
  15. - **Export presets** — Create reusable configurations for exporting collection data.
  16. - **Print layouts** — Generate layouts for specimen labels and collection documents.
  17. - **Data standards** — Retrieve field definitions, metadata schemas, and Darwin Core mappings.
  18. - **Document rendering** — Preview generated templates using synthetic collection data.
  19. - **Local data utilities** — Support future integrations with local NAHPU installations for data queries, validation, and collection management.
  20. ## Architecture
  21. Pudu is designed as a standalone MCP server that reuses existing NAHPU libraries, schemas, and documentation wherever possible.
  22. The proposed architecture consists of:
  23. - An MCP server implemented in Rust.
  24. - Shared computational libraries from the NAHPU ecosystem.
  25. - Structured documentation and versioned schemas.
  26. - GitHub integration for issues and release information.
  27. - Remote Streamable HTTP and local stdio transports.
  28. The remote server is intended to be stateless. Generated templates and configurations can be imported directly into NAHPU, preserving its offline-first architecture.
  29. ## MCP tools
  30. The following tools are proposed for the initial implementation.
  31. | Tool | Description |
  32. |---|---|
  33. | `search_docs` | Search NAHPU documentation. |
  34. | `get_doc` | Retrieve a documentation page. |
  35. | `search_issues` | Search known issues and feature requests. |
  36. | `get_issue` | Retrieve issue details. |
  37. | `get_releases` | Retrieve release information. |
  38. | `list_template_fields` | Discover supported template fields. |
  39. | `get_template_schema` | Retrieve a document template schema. |
  40. | `list_templates` | Discover built-in document templates. |
  41. | `create_template` | Generate a NAHPU-compatible document template. |
  42. | `validate_template` | Validate a document template. |
  43. | `create_export_preset` | Generate a record export preset. |
  44. | `create_print_layout` | Generate a print layout preset. |
  45. | `get_dwc_mapping` | Retrieve Darwin Core field mappings. |
  46. Tool definitions and availability may change during development.
  47. ## Usage
  48. Pudu is intended to support MCP-compatible clients, including AI assistants and development environments.
  49. The proposed public MCP endpoint is:
  50. `https://mcp.nahpu.app/mcp`
  51. ### Example requests
  52. Once connected to Pudu, users will be able to make requests such as:
  53. - Are there any known issues with importing specimen records in NAHPU?
  54. - Create a mammal specimen tag with scientific name, field number, locality, collector, and collection date.
  55. - Generate an export preset compatible with Darwin Core.
  56. - Create a print layout for specimen labels on A4 paper.
  57. - Validate this document template against the current NAHPU schema.
  58. - Explain how to export tissue and preparation records.
  59. Generated configurations are intended to be compatible with NAHPU's existing import and export workflows.
  60. ## Design principles
  61. - **Interoperability** — Use open protocols and standardized data formats.
  62. - **Independence** — Operate without requiring a running NAHPU installation.
  63. - **Privacy** — Do not require access to private collection databases for public tools.
  64. - **Reproducibility** — Generate portable, versioned, and validated configurations.
  65. - **Compatibility** — Maintain consistency with NAHPU's data models and schemas.
  66. - **Provider neutrality** — Support MCP-compatible clients regardless of their underlying AI models.
  67. - **Offline-first** — Preserve the ability to manage collection data locally without relying on AI services.
  68. ## Roadmap
  69. - [ ] Implement the core MCP server.
  70. - [ ] Support documentation search and retrieval.
  71. - [ ] Integrate GitHub issues and releases.
  72. - [ ] Publish machine-readable schemas and field catalogs.
  73. - [ ] Implement document template generation and validation.
  74. - [ ] Support export and print layout presets.
  75. - [ ] Implement document rendering and previews.
  76. - [ ] Deploy the public MCP endpoint.
  77. - [ ] Support local MCP installations.
  78. - [ ] Explore collection data validation and quality control tools.
  79. ## Project status
  80. Pudu is in early development. The architecture, tool definitions, and public service endpoints may change.
  81. ## Contributing
  82. Contributions, feature requests, and discussions are welcome. Please use the GitHub issue tracker to report bugs, propose new MCP tools, or discuss improvements to the project.
  83. ## Acknowledgments
  84. Pudu builds upon the [Model Context Protocol](https://modelcontextprotocol.io/) and the open-source libraries and tools developed within the NAHPU ecosystem.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.