Metadata-Version: 2.4
Name: agora-workbench
Version: 0.1.1
Summary: A toolkit for building MCP servers that provide sandboxed Python execution with domain-specific packages.
License-Expression: MIT
Project-URL: homepage, https://github.com/microsoft/agora-workbench
Project-URL: documentation, https://microsoft.github.io/agora-workbench
Project-URL: repository, https://github.com/microsoft/agora-workbench
Project-URL: changelog, https://github.com/microsoft/agora-workbench/blob/main/CHANGELOG.md
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: azure-core>=1.38.0
Requires-Dist: azure-data-tables>=12.7.0
Requires-Dist: azure-identity>=1.25.0
Requires-Dist: azure-search-documents>=11.4.0
Requires-Dist: azure-storage-blob[aio]>=12.28.0
Requires-Dist: fastapi>=0.115
Requires-Dist: fastmcp>=2.14.2
Requires-Dist: mcp>=1.28.1
Requires-Dist: starlette>=1.3.1
Requires-Dist: uvicorn>=0.34
Requires-Dist: wsproto>=1.3.2
Requires-Dist: cryptography>=48.0.1
Requires-Dist: msal>=1.28.0
Requires-Dist: pyjwt[crypto]>=2.8.0
Requires-Dist: pandas>=2.3.3
Requires-Dist: pyarrow>=22.0.0
Requires-Dist: pydantic>=2.10.4
Requires-Dist: pyyaml>=6.0
Requires-Dist: dill>=0.3.8
Requires-Dist: ipykernel>=6.29.0
Requires-Dist: jupyter-client>=8.6.0
Requires-Dist: pyzmq>=26.0.0
Requires-Dist: sqlite-vec>=0.1.9
Requires-Dist: httpx>=0.27.0
Requires-Dist: sse-starlette>=3.3.0
Requires-Dist: typeguard>=4.4.4
Requires-Dist: typing-extensions>=4.12.0
Provides-Extra: openai-agents
Requires-Dist: openai-agents>=0.15.0; extra == "openai-agents"
Provides-Extra: copilot-sdk
Requires-Dist: github-copilot-sdk>=1.0.0; extra == "copilot-sdk"
Requires-Dist: python-dotenv>=1.1.1; extra == "copilot-sdk"
Provides-Extra: geo
Requires-Dist: rasterio>=1.4.0; extra == "geo"
Requires-Dist: titiler.core>=0.19.0; extra == "geo"
Dynamic: license-file

# Agora Workbench
<p align="left">
  <img src="logo.png" alt="Agora Workbench logo" width="250">
</p>


![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
[![MIT License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

A workbench for wrapping your tooling with MCP

<h2><a href="https://microsoft.github.io/agora-workbench">Documentation</a></h2>

> [!IMPORTANT]
> **Research software and support**
>
> Agora Workbench is research software and is not an officially supported Microsoft product. It is provided
> as-is and may change without notice. No support, service-level commitments, or compatibility guarantees are
> provided. Issues and contributions are welcome, but responses, fixes, and continued maintenance are not
> guaranteed.

## Overview

Agora Workbench is a toolkit for building MCP (Model Context Protocol) servers that provide sandboxed Python execution with domain-specific packages. It is agent-framework agnostic — any MCP-compatible client can take advantage of the servers created by Agora Workbench.

Use Agora Workbench to:

- **Wrap domain-specific Python tooling as MCP servers** — expose Python environments through isolated, session-aware execution environments that any MCP client can call
- **Make tools discoverable** — register tools and skills in a searchable catalog so agents can find what they need by natural-language query
- **Serve data alongside code** — attach a file catalog so agents can locate and load datasets without hardcoded paths
- **Deploy to Azure Container Apps** — use the included Bicep templates and CLI to ship your servers with Entra ID auth and managed identity

## Getting Started

### Prerequisites

- **Python 3.11+**
- **Git**
- **[uv](https://docs.astral.sh/uv/)** for dependency management
- **Docker** (required for the bundled container examples and local Compose workflows)

### Installation

**With uv (recommended for development):**

```bash
git clone https://github.com/microsoft/agora-workbench.git
cd agora-workbench
uv sync --group dev  # install the project and dev tools
```

**With pip (for using as a library):**

```bash
pip install "agora-workbench==0.1.1"
```

The installed deployment CLI can also scaffold the standalone Activity UI:

```bash
agora-workbench-deploy init --target activity-ui
```

With uv, add the same release to your project with:

```bash
uv add "agora-workbench==0.1.1"
```

See the [changelog](https://github.com/microsoft/agora-workbench/blob/main/CHANGELOG.md) for release history and
[release guide](https://github.com/microsoft/agora-workbench/blob/main/RELEASING.md) for the versioning policy.

**Optional extras for examples** — the base package is all you need to build and run MCP servers. Extras pull in dependencies used by the example integrations:

| Extra | Example integration |
|-------|---------------------|
| `openai-agents` | OpenAI Agents SDK adapter |
| `copilot-sdk` | GitHub Copilot SDK adapter |
| `geo` | Geospatial example server dependencies (rasterio, etc.) |

Use the command for your installation method:

```bash
# uv (inside the cloned repo)
uv sync --extra openai-agents

# pip (consuming as a library)
pip install "agora-workbench[openai-agents]==0.1.1"
```

### Configuration

For local testing, no external credentials are required. Use the no-op auth config to skip authentication entirely:

```python
from agora_workbench.code_execution import CodeExecutionServer, ServerConfig
from agora_workbench.code_execution.auth import create_noop_auth_config

config = ServerConfig(
    name="myserver",
    description="My local test server",
    type="uv",
    dependency_file="numpy\npandas\n",
)
server = CodeExecutionServer(
    server_config=config,
    auth_config=create_noop_auth_config(),
)
```
For Docker-based local deployment and Azure Container Apps, see the [deployment guide](https://microsoft.github.io/agora-workbench/guide/deploying/). For Entra ID authentication setup, see the [authentication guide](https://microsoft.github.io/agora-workbench/guide/authentication/).

## Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit [Contributor License Agreements](https://cla.opensource.microsoft.com).

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

**Guidelines:**
- For changes more complex than typos, please submit an issue first to discuss the proposed changes
- Follow the development practices outlined in the project documentation

### Contact

For questions or feedback, please [open an issue](https://github.com/microsoft/agora-workbench/issues).

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.
