semvec/pypi-packages huggingface dataset:
nutritionix-mcp-server 0.1.1
A MCP server for interacting with the Nutritionix API via Model Context Protocol tools
License: MIT
Requires Python: >=3.11
Keywords: ai, automation, llm, mcp, nutrition, nutritionix

# 🥦 Nutritionix MCP Server

This is an **MCP (Model Context Protocol) server** for integrating with the [Nutritionix API](https://developer.nutritionix.com/), enabling AI agents to access food search, nutrition data, and exercise calorie estimates via natural language input.

The goal of this project is to expose Nutritionix's functionality through MCP-compatible tools that can be used seamlessly by large language models and agent frameworks.

---

## 🧠 What is MCP?

MCP (Model Context Protocol) is a lightweight protocol designed to let **AI agents interact with external tools and APIs** in a structured and modular way. Think of it like **USB for AI** — this server acts as a "driver" for the Nutritionix platform.

With this MCP server, AI models can:

- 🔍 Search for common and branded food items  
- 🍽️ Parse natural language meals into nutritional breakdowns  
- 🏃 Estimate calories burned from exercises like running, cycling, or yoga

---

# 🚀 How to Run

To use this MCP server, you'll need:

## ✅ Prerequisites

- Python 3.11+
- [`uv`](https://github.com/astral-sh/uv) – a modern Python package manager
- A supported LLM (e.g., Claude)
- A Nutritionix API App ID and App Key – get them at [developer.nutritionix.com](https://developer.nutritionix.com)

## Add this to Claude Desktop config

```json
{
  "mcpServers": {
    "nutritionix-mcp": {
      "command": "uvx",
      "args": [
        "nutritionix-mcp-server",
        "--app-id",
        "YOUR APP ID",
        "--app-key",
        "YOUR APP KEY"
      ]
    }
  }
}
```

---

## 🤝 Contributions Welcome!

Whether you're into nutrition tech, AI agent development, or API tooling — we’d love your help improving this project. You can contribute by:

- Adding new tools (e.g., barcode search, food logging)
- Improving response formatting
- Writing tests or documentation
- Suggesting new ideas via Issues or Discussions

Feel free to fork, explore, and submit a PR. Let’s make agent-integrated nutrition smarter, together. 🧠🥗

---

**MCP-FORGE** – Building tools for the future of intelligent automation.
python-project-template__Mala1180 1.1.0
A python project template, using Poetry.
License: MIT
Requires Python: <4.0,>=3.10

# python-project-template

A python project template, using Poetry.

## Setup Instructions

1. **Rename the Template**  
   Run the following command to rename the template to your desired project name:
    ```bash
    ./rename-template.sh <new_project_name>
    ```

2. **Install Poetry and Poethepoet**  
   If you don't have Poetry and Poe installed, you can install them from requirements using pip:
    ```bash
    pip install -r requirements.txt
    ```

3. **Install Project Dependencies**  
   Use Poetry to install all project dependencies:
    ```bash
    poetry install
    ```
4. **Setup Releases**
    - Add your `RELEASE_TOKEN` (see [Personal Access Tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)) to GitHub secrets (or modify [deploy.yml](.github/workflows/deploy.yml) to use
      `GITHUB_TOKEN`).
    - If you want to publish your package to PyPI, you need to add your `PYPI_TOKEN` to GitHub secrets.
        - Make sure to adopt [Conventional Commits](https://www.conventionalcommits.org/) to trigger properly [Semantic Release](https://github.com/DanySK/semantic-release-preconfigured-conventional-commits).

## Main Commands

- **Run Tests**  
  Execute the test suite using `pytest`:
  ```bash
  poe test
  ```
  
- **Run Tests with Coverage**  
  Execute the test suite with coverage reporting:
  ```bash
  poe coverage
  ```
  and generate a report with `poe coverage-report` or `poe coverage-html`
   

- **Run Static Checks**  
  Perform static code analysis using both `mypy` and `ruff`:
  ```bash
  poe static-checks
  ```
  
- **Format Code**  
  Format your code using `ruff`:
  ```bash
  poe format
  ```
  
Note: All these checks are required to pass in order to create a release.