anam-mcp 0.1.0__tar.gz

anam_mcp-0.1.0/.env.example

@@ -0,0 +1,6 @@
+# Anam API Key (required)
+# Get yours at: https://lab.anam.ai/api-keys
+ANAM_API_KEY=your-api-key-here
+
+# Optional: Override API base URL (for staging environments)
+# ANAM_API_URL=https://api.anam.ai

anam_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Validate version matches tag
+        run: |
+          TAG_VERSION=${GITHUB_REF#refs/tags/v}
+          PKG_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Tag version ($TAG_VERSION) does not match package version ($PKG_VERSION)"
+            exit 1
+          fi
+          echo "Version validated: $TAG_VERSION"
+
+  publish:
+    needs: validate
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        # Uses trusted publishing - no API token needed
+        # Configure at: https://pypi.org/manage/project/anam-mcp/settings/publishing/

anam_mcp-0.1.0/.gitignore

@@ -0,0 +1,101 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local development
+*.local
+.env.local

anam_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anam AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

anam_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: anam-mcp
+Version: 0.1.0
+Summary: Official Anam AI MCP server for managing AI personas
+Project-URL: Homepage, https://github.com/anam-org/anam-mcp
+Project-URL: Documentation, https://docs.anam.ai
+Project-URL: Repository, https://github.com/anam-org/anam-mcp
+Project-URL: Issues, https://github.com/anam-org/anam-mcp/issues
+Author-email: Anam AI <support@anam.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,anam,avatar,digital-human,mcp,persona
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Anam MCP Server
+
+Official MCP (Model Context Protocol) server for [Anam AI](https://anam.ai) - manage AI personas, avatars, voices, and sessions directly from Claude or any MCP client.
+
+## Installation
+
+### Using uvx (recommended)
+
+```bash
+uvx anam-mcp
+```
+
+### Using pip
+
+```bash
+pip install anam-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "anam": {
+      "command": "uvx",
+      "args": ["anam-mcp"],
+      "env": {
+        "ANAM_API_KEY": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "anam": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["anam-mcp"],
+      "env": {
+        "ANAM_API_KEY": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+## Getting Your API Key
+
+1. Sign up at [Anam Lab](https://lab.anam.ai)
+2. Navigate to the [API Keys page](https://lab.anam.ai/api-keys)
+3. Click "Create API key" and save it securely
+
+## Available Tools
+
+### Persona Management
+
+| Tool | Description |
+|------|-------------|
+| `list_personas` | List all personas in your account |
+| `get_persona` | Get details of a specific persona |
+| `create_persona` | Create a new persona with avatar, voice, and personality |
+| `update_persona` | Update an existing persona |
+| `delete_persona` | Delete a persona |
+
+### Avatar Management
+
+| Tool | Description |
+|------|-------------|
+| `list_avatars` | List all available avatars |
+| `create_avatar` | Create custom avatar from image (enterprise/pro) |
+| `delete_avatar` | Delete a custom avatar |
+
+### Voice Management
+
+| Tool | Description |
+|------|-------------|
+| `list_voices` | List all available voices (400+ in 50+ languages) |
+
+### Tool Management
+
+| Tool | Description |
+|------|-------------|
+| `list_tools` | List all tools in your organization |
+| `create_webhook_tool` | Create a webhook tool for API integrations |
+| `create_knowledge_tool` | Create a knowledge/RAG tool |
+| `delete_tool` | Delete a tool |
+
+### Session Management
+
+| Tool | Description |
+|------|-------------|
+| `create_session_token` | Generate a session token for the client SDK |
+
+### Knowledge Base
+
+| Tool | Description |
+|------|-------------|
+| `list_knowledge_folders` | List knowledge folders |
+| `create_knowledge_folder` | Create a new folder for documents |
+
+## Example Usage
+
+Once configured, you can ask Claude:
+
+- "List all my Anam personas"
+- "Create a new persona named 'Sales Assistant' with a friendly personality"
+- "What avatars are available?"
+- "Generate a session token for my customer support persona"
+
+## Default IDs
+
+For quick testing, you can use these default IDs:
+
+| Resource | ID |
+|----------|-----|
+| Avatar (Cara) | `30fa96d0-26c4-4e55-94a0-517025942e18` |
+| Voice (Cara) | `6bfbe25a-979d-40f3-a92b-5394170af54b` |
+| Default LLM | `0934d97d-0c3a-4f33-91b0-5e136a0ef466` |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ANAM_API_KEY` | Your Anam API key (required) | - |
+| `ANAM_API_URL` | API base URL (for staging) | `https://api.anam.ai` |
+
+## Documentation
+
+- [Anam Developer Docs](https://docs.anam.ai)
+- [API Reference](https://docs.anam.ai/api-reference)
+- [Avatar Gallery](https://docs.anam.ai/resources/avatar-gallery)
+- [Voice Gallery](https://docs.anam.ai/resources/voice-gallery)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.