README.md•2.56 kB
# Foundry MCP Server
A Model Context Protocol server for interacting with Foundry.
It allows AI assistants to interact with datasets, ontology objects and functions.
## Tools 🌟
- list datasets
- query datasets
- list ontology objects
- query ontology objects
- list functions
- execute functions
## Prerequisites
* Python 3.9+
* mcp
* pyarrow
* pandas
* foundry-platform-sdk
# Environment Variables 🌍
The server requires few configuration variables to run:
| Variable | Description | Default |
|------------------|----------------------------------------------------------------------|-------------|
| `HOSTNAME` | Your hostname of your Foundry instance | *required* |
| `TOKEN` | A user token that you can generate in your profile page | *required** |
| `CLIENT_ID` | A service user that is created in developer console | *required** |
| `CLIENT_SECRET` | A secret associated with the service user | *required** |
| `SCOPES` | Oauth scopes | None |
| `ONTOLOGY_ID` | Your ontology id | *required* |
* if token is not provided the server will try to authenticate using the oauth2 flow with client_id and client_secret
## Usage
### uv
first you need to clone the repository and add the config to your app
``` json
{
"mcpServers": {
"foundry": {
"command": "uv",
"args": [
"--directory",
"<path_to_mcp_server>",
"run",
"mcp-server-foundry"
],
"env": {
"HOSTNAME": "<hostname>",
"TOKEN": "<token>",
"CLIENT_ID": "<client_id>",
"CLIENT_SECRET": "<client_secret>",
"SCOPES": "<scopes>",
"ONTOLOGY_ID": "<ontology_id>"
}
}
}
}
```
## Development
To run the server in development mode:
```bash
# Clone the repository
git clone git@github.com:qwert666/mcp-server-foundry.git
# Run the server
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-foundry-server run mcp-server-foundry
```
# Contributing
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
# License 📜
MIT License - see LICENSE file for details