{
  "markdown": "# ![logo](https://raw.githubusercontent.com/open-and-sustainable/alembica/main/docs/assets/images/logo.png) `alembica`\n\n**Open Science Software for Semantic Synthesis and Extraction of Information from Unstructured Sources.**\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/open-and-sustainable/alembica.svg)](https://pkg.go.dev/github.com/open-and-sustainable/alembica) [![Go Report Card](https://goreportcard.com/badge/github.com/open-and-sustainable/alembica)](https://goreportcard.com/report/github.com/open-and-sustainable/alembica) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.14899666.svg)](https://doi.org/10.5281/zenodo.14899666)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-Alembica%20MCP-0A7B83)](https://registry.modelcontextprotocol.io/?q=alembica)\n\n---\n\n## About\n\n`alembica` simplifies the use of **Large Language Models (LLMs)** to extract structured datasets from unstructured corpora of text.\nIt provides a **flexible and scalable framework** to process, synthesize, and transform textual information into structured formats suitable for analysis and further processing.\n\nSupports **OpenAI, Google AI, Anthropic, Cohere, DeepSeek, Perplexity, AWS Bedrock, Azure AI, Vertex AI, and Self-Hosted OpenAI-compatible** providers.\n\n---\n\n## Installation (Go)\n\nTo install `alembica` in Go, run:\n\n```sh\ngo get github.com/open-and-sustainable/alembica\n```\n\nIf you want to use `alembica` in **other programming languages**, check out the C-Shared Library in the [User Guide](https://open-and-sustainable.github.io/alembica/).\n\n---\n\n## Documentation\n\n**[User Guide](https://open-and-sustainable.github.io/alembica/)** – Learn how to use `alembica` in different programming languages.\n**[API Reference](https://pkg.go.dev/github.com/open-and-sustainable/alembica)** – Explore the Go package documentation.\n\n## MCP Server\n`alembica` includes an optional MCP server for agent tool access.\n\nThe MCP server can be used from a locally built Go binary, the GHCR container image, or the MCP Registry.\n\nAvailable in the official MCP Registry:\n- https://registry.modelcontextprotocol.io/?q=alembica\n- Server ID: `io.github.open-and-sustainable/alembica-mcp`\n\nSee the User Guide MCP page for installation options, run commands, and tool schemas.\n\n## MCP Registry publishing\nThe MCP server is published to the MCP Registry by GitHub Actions when a version tag such as `v1.2.3` is pushed.\n\nThe workflow uses GitHub OIDC for authentication, and each new registry version is published explicitly by CI rather than implicitly from GitHub Releases.\n\n---\n\n## Features\n\n- **Validation of Input** – Ensures that queries are correctly formatted to support proper interaction with models.\n- **Cost Assessment** – Calculates token costs based on the requested extraction and different model pricing.\n- **Data Extraction** – Processes unstructured text and transforms it into structured datasets for further analysis.\n\nNote: Cost estimation is not supported for Self-Hosted, AWS Bedrock, Azure AI, or Vertex AI providers and will return zero.\n\nOptional model fields for cloud/local providers:\n- `base_url` and `api_version` for Azure/OpenAI-compatible endpoints\n- `region` for AWS Bedrock\n- `project_id` and `location` for Vertex AI\n\nUse `schemaVersion: \"v2\"` when you need these cloud/local provider fields or non-enumerated model IDs.\n\n---\n\n## Authors & Contributions\n\n**Author**: Riccardo Boero - [ribo@nilu.no](mailto:ribo@nilu.no)\n\nContributions are welcome!\n\n---\n\n## License\n\n`alembica` is licensed under the **GNU AFFERO GENERAL PUBLIC LICENSE, Version 3**.\n\n![AGPL License](https://www.gnu.org/graphics/agplv3-155x51.png)\n\n---\n\n## Citation\n\n> **Boero, R. (2025).** *`alembica` - Open Science Software for Semantic Synthesis and Extraction of Information from Unstructured Sources.* Zenodo.\n> [https://doi.org/10.5281/zenodo.14899666](https://doi.org/10.5281/zenodo.14899666)\n",
  "bytes": 3892,
  "sha": "e3a44500886e317fee076a836db8c937482b8cbaaeed09e363b5a9a2b4eb4727",
  "repo_slug": "open-and-sustainable/alembica",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_open_and_sustainable_alembica__6200eaec/readme"
}