Secoda MCP is a custom server built with FastMCP that provides access to Secoda's data tools and functionalities.
- Access to Secoda's data assets search
- Access to documentation search
- Ability to run SQL queries directly
- Integration with Secoda's data catalog
- Entity lineage visualization
- Glossary term retrieval
- Python 3.8 or higher
- Access to Secoda's API
- API token for authentication with the Secoda API (can be generated at https://app.secoda.co/settings/api if you're an admin)
-
Clone the repository:
git clone https://github.com/secoda/secoda-mcp.git cd secoda-mcp -
Install dependencies:
# Install runtime dependencies python -m pip install -r requirements.txt
| Variable | Description | Default |
|---|---|---|
API_TOKEN |
Required token for API authentication | None (Required) |
API_URL |
URL of the Secoda API endpoint | https://app.secoda.co/api/v1/ |
If you're using a regional instance or self-hosted deployment of Secoda, replace app.secoda.co with your specific instance URL:
- EU region:
eu.secoda.co - APAC region:
apac.secoda.co - Self-hosted: Your custom domain (e.g.,
secoda.yourcompany.com)
To integrate Secoda MCP with Cursor, add the following configuration to your ~/.cursor/mcp.json file:
{
"mcpServers": {
"secoda-mcp": {
"command": "python",
"args": [
"/path/to/secoda-mcp/server.py"
],
"env": {
"API_TOKEN": "your-api-token",
"API_URL": "https://app.secoda.co/api/v1/"
}
}
}
}Replace /path/to/secoda-mcp/server.py with the
7BFE
actual path to your server.py file, set your API token, and update the API_URL with your Secoda instance URL if not using app.secoda.co.
To integrate Secoda MCP with Claude Desktop, add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"secoda-mcp": {
"command": "python",
"args": [
"/path/to/secoda-mcp/server.py"
],
"env": {
"API_TOKEN": "your-api-token",
"API_URL": "https://app.secoda.co/api/v1/"
}
}
}
}Replace /path/to/secoda-mcp/server.py with the actual path to your server.py file, set your API token, and update the API_URL with your specific Secoda instance URL if not using app.secoda.co. To access the Claude Desktop configuration file, open the Claude menu, go to "Settings", click on "Developer" in the left-hand bar, and then click on "Edit Config".
After updating the configuration, restart Claude Desktop to apply the changes.
Secoda MCP can be integrated with various other tools:
- VS Code: Use the VS Code extension for MCP servers
- JetBrains IDEs: Install the MCP plugin from the marketplace
- Command Line: Access MCP functionalities directly via the CLI
- Web Applications: Embed MCP capabilities in web apps through the REST API
- If you encounter connection issues, ensure Secoda's API is running at the configured URL
- If you get authorization errors, verify your API token is correct and properly set as an environment variable
- For permission errors, check your authentication settings in your Secoda account
This project is licensed under the MIT License - see the LICENSE file for details.
If you discover any security related issues, please email security@secoda.co instead of using the issue tracker.