linkedin-ads-mcp-server-by-cdata

Serveur MCP (Model Context Protocol) de CData pour les publicités LinkedIn

:heavy_exclamation_mark : Ce projet construit un serveur MCP en lecture seule. Pour des capacités complètes de lecture, d'écriture, de mise à jour, de suppression et d'action et une configuration simplifiée, consultez notre serveur MCP CData gratuit pour LinkedIn Ads (beta).

Objectif

Nous avons créé ce serveur MCP en lecture seule pour permettre aux LLM (comme Claude Desktop) d'interroger les données en direct des publicités LinkedIn prises en charge par le pilote CData JDBC pour les publicités LinkedIn.

Le pilote CData JDBC se connecte aux annonces LinkedIn en les exposant comme des modèles relationnels SQL.

Ce serveur enveloppe ce pilote et rend les données LinkedIn Ads disponibles à travers une simple interface MCP, de sorte que les LLM peuvent récupérer des informations en direct en posant des questions en langage naturel - pas de SQL requis.

Guide d'installation

1. Cloner le dépôt :

   git clone https://github.com/cdatasoftware/linkedin-ads-mcp-server-by-cdata.git cd linkedin-ads-mcp-server-by-cdata

2. Construire le serveur :

   mvn clean install

   Cela crée le fichier JAR : CDataMCP-jar-with-dependencies.jar
3. Téléchargez et installez le pilote JDBC de CData pour {source} : https://www.cdata.com/drivers/linkedinads/download/jdbc
4. Licence du pilote JDBC de CData
   • Accédez au dossier lib dans le répertoire d'installation, généralement
     • (Windows) C:\NProgram Files\NCData\NCData JDBC Driver for LinkedIn Ads\N (Windows) C:\NProgram Files\NCData\NCData JDBC Driver for LinkedIn Ads\N
     • (Mac/Linux) /Applications/CData JDBC Driver for LinkedIn Ads/
   • Exécutez la commande java -jar cdata.jdbc.linkedinads.jar --license
   • Saisissez votre nom, votre adresse électronique et "TRIAL" (ou votre clé de licence).
5. Configurez votre connexion à la source de données (Salesforce par exemple)

   • Exécutez la commande java -jar cdata.jdbc.linkedinads.jar pour ouvrir l'utilitaire Connection String.

   • Configurez la chaîne de connexion et cliquez sur "Tester la connexion"

     Remarque : si la source de données utilise OAuth, vous devrez vous authentifier dans votre navigateur.

   • Une fois le test réussi, copiez la chaîne de connexion pour l'utiliser ultérieurement.

6. Créez un fichier .prp pour votre connexion JDBC (par exemple linkedin-ads.prp) en utilisant les propriétés et le format suivants
   • Prefix - préfixe à utiliser pour les outils exposés
   • ServerName - nom de votre serveur
   • ServerVersion - version de votre serveur
   • DriverPath - le chemin complet vers le fichier JAR de votre pilote JDBC
   • DriverClass - nom de la classe du pilote JDBC (par exemple, cdata.jdbc.linkedinads.LinkedInAdsDriver)
   • JdbcUrl - la chaîne de connexion JDBC à utiliser avec le pilote JDBC de CData pour se connecter à vos données (copiée de ci-dessus)
   • Tables - laissez vide pour accéder à toutes les données, sinon vous pouvez déclarer explicitement les tables pour lesquelles vous souhaitez créer un accès

     Prefix=linkedinads ServerName=CDataLinkedInAds ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.linkedinads.jar DriverClass=cdata.jdbc.linkedinads.LinkedInAdsDriver JdbcUrl=jdbc:linkedinads:InitiateOAuth=GETANDREFRESH ; Tables=

Utilisation du serveur avec Claude Desktop

1. Créer le fichier de configuration pour Claude Desktop ( claude_desktop_config.json) pour ajouter le nouveau serveur MCP, en utilisant le format ci-dessous. Si le fichier existe déjà, ajoutez l'entrée à mcpServers dans le fichier de configuration.

   Windows

   {"mcpServers" : {"{classname_dash}" : {"command" : "PATH\TO\java.exe", "args" : ["-jar", "PATH\TO\CDataMCP-jar-with-dependencies.jar", "PATH\TO\linkedin-ads.prp" ] }, ... }

   Linux/Mac

   { "mcpServers" : {"{classname_dash}" : {"command" : "/PATH/TO/java", "args" : [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/linkedin-ads.prp" ] }, ... } }

   Si nécessaire, copiez le fichier de configuration dans le répertoire approprié (Claude Desktop dans l'exemple).Windows

   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json

   Linux/Mac

   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'

2. Exécutez ou actualisez votre client (Claude Desktop).

Note : Il se peut que vous deviez quitter complètement votre client Claude Desktop et le rouvrir pour que les serveurs MCP apparaissent.

Exécution du serveur

1. Exécutez la commande suivante pour lancer le serveur MCP sur son propre site

   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Note : Le serveur utilise stdio et ne peut donc être utilisé qu'avec des clients qui tournent sur la même machine que le serveur.

Détails d'utilisation

Une fois le serveur MCP configuré, le client AI pourra utiliser les outils intégrés pour lire, écrire, mettre à jour et supprimer les données sous-jacentes. En général, il n'est pas nécessaire d'appeler les outils de manière explicite. Il suffit de demander au client de répondre à des questions sur le système de données sous-jacent. Par exemple : "Quelle est la corrélation entre mes données de base et mes données de base ?

• "Quelle est la corrélation entre mes opportunités gagnées et fermées et le secteur d'activité du compte ?
• "Combien de tickets ouverts ai-je dans le projet SUPPORT ?
• "Pouvez-vous me dire quels sont les événements du calendrier que j'ai aujourd'hui ?

La liste des outils disponibles et leurs descriptions suivent :

Outils et descriptions

Dans les définitions ci-dessous, {servername} fait référence au nom du serveur MCP dans le fichier de configuration (par exemple {classname_dash} ci-dessus).

• {servername}_get_tables - Récupère une liste de tables disponibles dans la source de données. Utilisez l'outil {servername}_get_columns pour dresser la liste des colonnes disponibles sur une table. La sortie de l'outil sera renvoyée au format CSV, la première ligne contenant les en-têtes des colonnes.
• {servername}_get_columns - Récupère une liste de colonnes pour une table. Utilisez l'outil {servername}_get_tables pour obtenir une liste des tables disponibles. La sortie de l'outil sera renvoyée au format CSV, la première ligne contenant les en-têtes des colonnes.
• {servername}_run_query - Exécuter une requête SQL SELECT

Exemples de requêtes JSON-RPC

Si vous écrivez les requêtes envoyées au serveur MCP au lieu d'utiliser un client AI (par exemple Claude), vous pouvez vous référer aux exemples de charge utile JSON ci-dessous - conformément à la spécification JSON-RPC 2.0 - lorsque vous appelez les outils disponibles.

source_get_tables

{"jsonrpc" : "2.0", "id" : 1, "method" : "tools/call", "params" : { "name" : "source_get_tables", "arguments" : {} } }

source_get_columns

{ "jsonrpc" : "2.0", "id" : 2, "method" : "tools/call", "params" : { "name" : "source_get_columns", "arguments" : { "table" :  "Account" } } }

source_run_query

{ "jsonrpc" : "2.0", "id" : 3, "method" : "tools/call", "params" : { "name" : "source_run_query", "arguments" : { "sql" :  "SELECT * FROM [Account] WHERE [IsDeleted] = true" } } }

Dépannage

1. Si vous ne pouvez pas voir votre serveur CData MCP dans Claude Desktop, assurez-vous que vous avez complètement quitté Claude Desktop (Windows : utilisez le gestionnaire de tâches, Mac : utilisez le moniteur d'activité)
2. Si Claude Desktop n'est pas en mesure de récupérer des données, assurez-vous que vous avez configuré votre connexion correctement. Utilisez le constructeur de chaîne de connexion pour créer la chaîne de connexion (voir ci-dessus) et copiez la chaîne de connexion dans le fichier de propriété (.prp).
3. Si vous rencontrez des difficultés pour vous connecter à votre source de données, contactez l'équipe d'assistance CData.
4. Si vous avez des difficultés à utiliser le serveur MCP, ou si vous avez d'autres commentaires, rejoignez la communauté CData.

Licence

Ce serveur MCP est sous licence MIT. Cela signifie que vous êtes libre d'utiliser, de modifier et de distribuer le logiciel, sous réserve des termes et conditions de la licence MIT. Pour plus de détails, veuillez consulter le fichier LICENSE dans le référentiel du projet.

Toutes les sources supportées