Orquestacion De Agentes
БесплатноНе проверенMCP server that exposes tools to query an e-commerce database (customers, sales, products) using natural language, orchestrated by a LangChain agent with Groq's
Описание
MCP server that exposes tools to query an e-commerce database (customers, sales, products) using natural language, orchestrated by a LangChain agent with Groq's LLM.
README
��# M C P O r q u e s t a c i o n d e A g e n t e s
# >��� M C P - O r q u e s t a c i � n d e A g e n t e s c o n F a s t M C P y G r o q
# # C r e a c i � n d e l p r i m e r f l u j o d e o r q u e s t a c i � n / i n t e g r a c i � n d e c a p a c i d a d e s e n u n s i s t e m a d e a g e n t e s
[ ! [ O p e n I n C o l a b ] ( h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m / a s s e t s / c o l a b - b a d g e . s v g ) ] ( h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m / g i t h u b / t u - u s u a r i o / M C P - O r q u e s t a c i o n - A g e n t e s / b l o b / m a i n / n o t e b o o k s / P l a n t i l l a M C P M u l t i F u e n t e F a s t M C P L a n g C h a i n O p e n A I - d a v i d - y u r i v i l c a . i p y n b )
- - -
# # =��� I N F O R M A C I � N G E N E R A L
| C a m p o | V a l o r |
| - - - - - - - | - - - - - - - |
| T � t u l o | C r e a c i � n d e l p r i m e r f l u j o d e o r q u e s t a c i � n / i n t e g r a c i � n d e c a p a c i d a d e s e n u n s i s t e m a d e a g e n t e s |
| C u r s o | C E R T I A I A R C H I T E C T O N L I N E 2 0 2 6 I I L I M A |
| D o c e n t e | I G N A C I O A L E X I S Z A M B R A N O C A R R I L L O |
| A u t o r | D a v i d Y u r i v i l c a |
| F e c h a | J u l i o 2 0 2 6 |
| I n s t i t u c i � n | B S G I n s t i t u t e |
- - -
# # <د� O B J E T I V O
D i s e � a r , c o n s t r u i r y o r q u e s t a r u n s i s t e m a d e a g e n t e s q u e i n t e g r a m � l t i p l e s c a p a c i d a d e s u t i l i z a n d o e l M o d e l C o n t e x t P r o t o c o l ( M C P ) c o m o e s t � n d a r d e c o m u n i c a c i � n , d e m o s t r a n d o :
- ' I d e n t i f i c a c i � n d e c a p a c i d a d e s d e n e g o c i o
- ' D i s e � o d e h e r r a m i e n t a s ( t o o l s ) M C P
- ' I m p l e m e n t a c i � n c o n F a s t M C P
- ' O r q u e s t a c i � n c o n L a n g C h a i n + G r o q
- ' T r a z a b i l i d a d y s e g u r i d a d
- - -
# # =��� C O N T E X T O D E L N E G O C I O
E - c o m m e r c e d e p r o d u c t o s a l i m e n t i c i o s e n A r g e n t i n a
E l d a t a s e t s i m u l a l a s o p e r a c i o n e s d e u n a e m p r e s a d e e - c o m m e r c e , p e r m i t i e n d o :
- A n � l i s i s d e c l i e n t e s p o r r e g i � n ( 6 r e g i o n e s a r g e n t i n a s )
- E v a l u a c i � n d e p r o d u c t o s y c a t e g o r � a s ( 8 c a t e g o r � a s )
- E s t u d i o d e m � t o d o s d e p a g o ( 5 m � t o d o s )
- I d e n t i f i c a c i � n d e o p o r t u n i d a d e s c o m e r c i a l e s
# # # =��� D a t o s d i s p o n i b l e s
| T a b l a | R e g i s t r o s | D e s c r i p c i � n |
| - - - - - - - | - - - - - - - - - - - | - - - - - - - - - - - - - |
| c l i e n t e s | 3 2 6 | D a t o s d e m o g r � f i c o s d e c l i e n t e s |
| v e n t a s | 3 , 0 2 9 | T r a n s a c c i o n e s c o m p l e t a s |
| p r o d u c t o s | 3 8 | C a t � l o g o d e p r o d u c t o s |
| c a t e g o r i a s | 8 | C l a s i f i c a c i � n d e p r o d u c t o s |
| m e t o d o s _ p a g o | 5 | M e d i o s d e p a g o d i s p o n i b l e s |
- - -
# # =���� T E C N O L O G � A S U T I L I Z A D A S
| T e c n o l o g � a | P r o p � s i t o |
| - - - - - - - - - - - - | - - - - - - - - - - - |
| P y t h o n 3 . 1 0 + | L e n g u a j e p r i n c i p a l |
| F a s t M C P | F r a m e w o r k p a r a s e r v i d o r e s M C P |
| L a n g C h a i n 1 . 0 + | O r q u e s t a c i � n d e a g e n t e s |
| L a n g G r a p h | B a c k e n d d e a g e n t e s c o n e s t a d o |
| G r o q ( L L a M A 3 . 3 7 0 B ) | M o d e l o L L M c o n t o o l c a l l i n g |
| S Q L i t e | B a s e d e d a t o s l o c a l |
| G o o g l e C o l a b | E n t o r n o d e e j e c u c i � n |
- - -
# # =� A R Q U I T E C T U R A D E L S I S T E M A
t x t % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % U S U A R I O F I N A L % % ( I n t e r a c t � a e n l e n g u a j e n a t u r a l ) % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %,% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % �% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % A G E N T E L A N G C H A I N % % ( O r q u e s t a d o r + R a z o n a m i e n t o ) % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % 1 . R e c i b e l a p r e g u n t a d e l u s u a r i o % % % % 2 . I n t e r p r e t a l a i n t e n c i � n u s a n d o G r o q ( L L a M A 3 . 3 7 0 B ) % % % % 3 . A p l i c a e l S y s t e m P r o m p t ( p o l � t i c a s y r e g l a s ) % % % % 4 . S e l e c c i o n a l a ( s ) h e r r a m i e n t a ( s ) n e c e s a r i a ( s ) % % % % 5 . E j e c u t a e l l o o p d e o r q u e s t a c i � n % % % % 6 . G e n e r a r e s p u e s t a f i n a l c o n e v i d e n c i a % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %,% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % �% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % M C P C L I E N T ( L a n g C h a i n A d a p t e r ) % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % " C o n e c t a a l s e r v i d o r M C P v � a H T T P % % % % " D e s c u b r e h e r r a m i e n t a s d i s p o n i b l e s % % % % " E j e c u t a l l a m a d a s a h e r r a m i e n t a s ( t o o l c a l l s ) % % % % " G e s t i o n a l a c o m u n i c a c i � n c o n e l s e r v i d o r M C P % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %,% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % �% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % M C P S E R V E R ( F a s t M C P ) % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % H E R R A M I E N T A S ( T O O L S ) E X P U E S T A S % % % % % % % % =�9� b u s c a r _ c l i e n t e s =�9� p e r f i l _ c o n s u m o _ c l i e n t e % % % % =�9� c l i e n t e s _ a l t o _ v a l o r =�9� t o p _ p r o d u c t o s _ v e n d i d o s % % % % =�9� a n a l i s i s _ c a t e g o r i a =�9� v e n t a s _ p o r _ r e g i o n % % % % =�9� p r e f e r e n c i a _ m e t o d o _ p a g o =�9� c a l c u l a r _ n i v e l _ c l i e n t e % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % % % ' V a l i d a c i � n d e p a r � m e t r o s ( t i p o s y l � m i t e s ) % % % % % % ' M a n e j o d e e r r o r e s ( t r y / e x c e p t ) % % % % % % ' C o n s u l t a s S Q L p a r a m e t r i z a d a s ( s e g u r i d a d ) % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %,% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % �% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %% % S Q L i t e D A T A B A S E % % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % C L I E N T E S % % V E N T A S % % P R O D U C T O S % % C A T E G O R I A S % % % % 3 2 6 r e g . % % 3 , 0 2 9 r e g . % % 3 8 r e g . % % 8 r e g . % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % %% % % % M E T O D O S _ P A G O % % % % 5 r e g . % % % % % % % % % % % % % % % % %% % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % % %%
- - -
# # =�'� T O O L S I M P L E M E N T A D A S
| T o o l | P r o p � s i t o | R i e s g o |
| - - - - - - | - - - - - - - - - - - | - - - - - - - - |
| b u s c a r _ c l i e n t e s | B u s c a r c l i e n t e s p o r n o m b r e , a p e l l i d o o r e g i � n | B a j o |
| p e r f i l _ c o n s u m o _ c l i e n t e | P e r f i l c o m p l e t o d e c o n s u m o d e u n c l i e n t e | B a j o |
| c l i e n t e s _ a l t o _ v a l o r | I d e n t i f i c a r c l i e n t e s c o n a l t o g a s t o | B a j o |
| t o p _ p r o d u c t o s _ v e n d i d o s | P r o d u c t o s m � s v e n d i d o s | B a j o |
| a n a l i s i s _ c a t e g o r i a | A n � l i s i s d e v e n t a s p o r c a t e g o r � a | B a j o |
| v e n t a s _ p o r _ r e g i o n | R e s u m e n d e v e n t a s p o r r e g i � n | B a j o |
| p r e f e r e n c i a _ m e t o d o _ p a g o | P r e f e r e n c i a s d e m � t o d o s d e p a g o | B a j o |
| c a l c u l a r _ n i v e l _ c l i e n t e | C l a s i f i c a r c l i e n t e s ( V I P , P r e m i u m , R e g u l a r ) | B a j o |
- - -
# # =��� G U � A D E U S U A R I O P A S O A P A S O
# # # =�'� P R E R R E Q U I S I T O S
1 . C u e n t a d e G o o g l e ( p a r a a c c e d e r a C o l a b )
2 . C u e n t a e n G r o q ( p a r a o b t e n e r A P I K e y g r a t u i t a )
- R e g i s t r a r e n : h t t p s : / / c o n s o l e . g r o q . c o m /
- G e n e r a r A P I K e y e n e l d a s h b o a r d
# # # =� E J E C U C I � N E N G O O G L E C O L A B
# # # # P a s o 1 : A b r i r e l n o t e b o o k e n C o l a b
O p c i � n A - D e s d e e l r e p o s i t o r i o :
b a s h # C l o n a r e l r e p o s i t o r i o g i t c l o n e h t t p s : / / g i t h u b . c o m / t u - u s u a r i o / M C P - O r q u e s t a c i o n - A g e n t e s . g i t # O a b r i r d i r e c t a m e n t e e n C o l a b : # h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m / g i t h u b / t u - u s u a r i o / M C P - O r q u e s t a c i o n - A g e n t e s / b l o b / m a i n / n o t e b o o k s / P l a n t i l l a M C P M u l t i F u e n t e F a s t M C P L a n g C h a i n O p e n A I - d a v i d - y u r i v i l c a . i p y n b
O p c i � n B - S u b i r m a n u a l m e n t e :
1 . D e s c a r g a r e l a r c h i v o . i p y n b
2 . I r a h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m /
3 . C l i c k e n " S u b i r " �! S e l e c c i o n a r e l a r c h i v o
# # # # P a s o 2 : C o n f i g u r a r l a A P I K e y d e G r o q
E n l a F a s e 3 , e l n o t e b o o k s o l i c i t a r � l a A P I K e y :
p y t h o n # B u s c a e s t a c e l d a y e j e c � t a l a G R O Q _ A P I _ K E Y : � � � � � � � � � � # I n g r e s a t u A P I K e y a q u �
� D � n d e o b t e n e r l a ?
1 . V e a [ h t t p s : / / c o n s o l e . g r o q . c o m / ] ( h t t p s : / / c o n s o l e . g r o q . c o m / )
2 . I n i c i a s e s i � n c o n t u c u e n t a
3 . V e a " A P I K e y s " e n e l m e n � l a t e r a l
4 . C l i c k e n " C r e a t e A P I K e y "
5 . C o p i a l a c l a v e g e n e r a d a
# # # # P a s o 3 : S u b i r l o s a r c h i v o s C S V
E n l a F a s e 3 , e l n o t e b o o k m o s t r a r � u n b o t � n p a r a s u b i r a r c h i v o s :
1 . H a z c l i c e n " C h o o s e F i l e s "
2 . S e l e c c i o n a l o s 5 a r c h i v o s C S V :
- c l i e n t e s . c s v
- v e n t a s . c s v
- p r o d u c t o s . c s v
- c a t e g o r i a s . c s v
- m e t o d o s _ p a g o . c s v
[ h t t p s : / / v i a . p l a c e h o l d e r . c o m / 6 0 0 x 2 0 0 ? t e x t = U p l o a d + C S V + F i l e s ] ( h t t p s : / / v i a . p l a c e h o l d e r . c o m / 6 0 0 x 2 0 0 ? t e x t = U p l o a d + C S V + F i l e s )
# # # # P a s o 4 : E j e c u t a r e l n o t e b o o k s e c u e n c i a l m e n t e
E l n o t e b o o k e s t � o r g a n i z a d o e n 1 1 f a s e s . E j e c u t a c a d a c e l d a e n o r d e n :
| F a s e | C e l d a s | Q u � h a c e | T i e m p o e s t i m a d o |
| - - - | - - - | - - - | - - - |
| F a s e 0 - 2 | 1 - 6 | D i s e � o y p l a n i f i c a c i � n | 5 m i n |
| F a s e 3 | 7 - 1 0 | C a r g a d e d a t o s a S Q L i t e | 3 m i n |
| F a s e 4 | 1 1 - 1 9 | P r u e b a s d e c o n s u l t a s S Q L | 5 m i n |
| F a s e 5 | 2 0 - 2 2 | C r e a c i � n d e l M C P S e r v e r | 2 m i n |
| F a s e 6 | 2 3 | L e v a n t a r e l s e r v i d o r | 1 m i n |
| F a s e 7 | 2 4 - 2 5 | D e s c u b r i r y p r o b a r t o o l s | 3 m i n |
| F a s e 8 | 2 6 | D e f i n i r S y s t e m P r o m p t | 1 m i n |
| F a s e 9 | 2 7 - 3 0 | C r e a r e l a g e n t e c o n G r o q | 2 m i n |
| F a s e 1 0 | 3 1 - 3 7 | E j e c u t a r p r u e b a s | 1 0 m i n |
| F a s e 1 1 | 3 8 - 3 9 | E v a l u a c i � n y l i m p i e z a | 2 m i n |
# # # # P a s o 5 : V e r i f i c a r e l s e r v i d o r M C P
E n l a F a s e 6 , v e r � s u n m e n s a j e c o m o e s t e :
t x t ' M C P S e r v e r a c t i v o ! U R L : h t t p : / / 1 2 7 . 0 . 0 . 1 : 8 0 0 0 / m c p P I D : 1 2 3 4 5 L o g : / c o n t e n t / m i _ m c p _ s e r v e r . l o g
S i v e s e s t e m e n s a j e , e l s e r v i d o r e s t � f u n c i o n a n d o c o r r e c t a m e n t e . <؉�
* * *
# # # # P a s o 6 : E j e c u t a r l a s p r u e b a s
E n l a * * F a s e 1 0 * * , v e r � s p r e g u n t a s d e e j e m p l o :
p y t h o n # P r u e b a 1 : P r o d u c t o m � s v e n d i d o r e s u l t a d o = a w a i t c o n s u l t a r _ a g e n t e ( " � C u � l e s e l p r o d u c t o m � s v e n d i d o e n c a n t i d a d ? " )
* * * R e s u l t a d o E s p e r a d o * * *
t x t =��� R E S P U E S T A F I N A L E l p r o d u c t o m � s v e n d i d o e n c a n t i d a d e s e l d e H a m b u r g e s a s c o n g e l a d a s , c o n u n t o t a l d e 3 8 2 u n i d a d e s v e n d i d a s y $ 3 , 4 3 8 d e i n g r e s o s t o t a l e s .
* * R e s u l t a d o e s p e r a d o : * *
t e x t =��� R E S P U E S T A F I N A L E l p r o d u c t o m � s v e n d i d o e n c a n t i d a d e s e l d e H a m b u r g e s a s c o n g e l a d a s , c o n u n t o t a l d e 3 8 2 u n i d a d e s v e n d i d a s y $ 3 , 4 3 8 d e i n g r e s o s t o t a l e s .
* * *
# # # =��� E J E M P L O S D E P R E G U N T A S P A R A P R O B A R
# # # # B � s i c a s ( 1 t o o l )
t e x t " � C u � l e s e l p r o d u c t o m � s v e n d i d o ? " " B u s c a c l i e n t e s d e l a r e g i � n P a t a g o n i a " " D a m e e l p e r f i l d e l c l i e n t e D a n P a r k i n ( I D : 4 ) " " � Q u � c a t e g o r � a d e p r o d u c t o s g e n e r a m � s i n g r e s o s ? "
# # # # I n t e r m e d i a s ( 2 - 3 t o o l s )
t e x t " I d e n t i f i c a l o s 5 c l i e n t e s q u e m � s h a n g a s t a d o , d i m e s u r e g i � n y c l a s i f i c a s u n i v e l " " � C u � n t o v e n d i m o s e n l a r e g i � n B u e n o s A i r e s ? " " � Q u � m � t o d o d e p a g o e s e l m � s u t i l i z a d o p o r l o s c l i e n t e s ? "
# # # # A v a n z a d a s ( 5 + t o o l s ) - D e s a f � o
t e x t R e a l i z a u n a n � l i s i s c o m p l e t o d e l a r e g i � n P a t a g o n i a : 1 . � C u � n t o s c l i e n t e s h a y e n P a t a g o n i a ? 2 . � C u � l e s s o n l o s 3 p r o d u c t o s m � s v e n d i d o s e n P a t a g o n i a ? 3 . � Q u � c a t e g o r � a g e n e r a m � s i n g r e s o s e n P a t a g o n i a ? 4 . � Q u � m � t o d o d e p a g o p r e f i e r e n l o s c l i e n t e s d e P a t a g o n i a ? 5 . � Q u � r e c o m e n d a c i o n e s d a r � a s p a r a a u m e n t a r l a s v e n t a s e n e s t a r e g i � n ?
* * *
# # # S' S O L U C I � N D E P R O B L E M A S C O M U N E S
# # # # E r r o r : " G R O Q \ _ A P I \ _ K E Y n o c o n f i g u r a d a "
b a s h # A s e g � r a t e d e h a b e r e j e c u t a d o l a c e l d a q u e s o l i c i t a l a A P I K e y # S i n o f u n c i o n a , r e i n i c i a e l r u n t i m e y v u e l v e a e j e c u t a r
# # # # E r r o r : " E l s e r v i d o r n o i n i c i � "
b a s h # V e r i f i c a q u e l a b a s e d e d a t o s s e c r e � c o r r e c t a m e n t e ! l s - l a / c o n t e n t / m c p _ l a b o r a t o r i o . d b # V e r i f i c a q u e e l a r c h i v o d e l s e r v i d o r e x i s t e ! l s - l a / c o n t e n t / m i _ m c p _ s e r v e r . p y # R e v i s a e l l o g d e l s e r v i d o r ! c a t / c o n t e n t / m i _ m c p _ s e r v e r . l o g
# # # # E r r o r : " P u e r t o 8 0 0 0 o c u p a d o "
b a s h # L i b e r a e l p u e r t o y r e i n i c i a ! f u s e r - k 8 0 0 0 / t c p 2 > / d e v / n u l l | | t r u e
# # # # E r r o r e n l a s p r u e b a s S Q L
b a s h # V e r i f i c a q u e l o s a r c h i v o s C S V s e s u b i e r o n c o r r e c t a m e n t e # E j e c u t a l a F a s e 3 n u e v a m e n t e
* * *
# # =��� R E S U L T A D O S D E L L A B O R A T O R I O
| M � t r i c a | V a l o r |
| - - - | - - - |
| C a p a c i d a d e s i d e n t i f i c a d a s | 8 |
| T o o l s i m p l e m e n t a d a s | 8 |
| P r u e b a s S Q L e x i t o s a s | 8 / 8 |
| P r u e b a s m a n u a l e s e x i t o s a s | 8 / 8 |
| P r u e b a s d e l a g e n t e e x i t o s a s | 7 / 7 |
| C r i t e r i o s d e e v a l u a c i � n | 8 / 8 ( 1 0 0 % ) |
# # # P r i n c i p a l e s h a l l a z g o s d e n e g o c i o
| H a l l a z g o | V a l o r |
| - - - | - - - |
| * * P r o d u c t o m � s v e n d i d o * * | H a m b u r g e s a s c o n g e l a d a s ( 3 8 2 u n i d a d e s ) |
| * * C a t e g o r � a c o n m � s i n g r e s o s * * | C a r n i c e r � a ( $ 2 7 , 6 1 5 - 2 7 . 5 8 % ) |
| * * R e g i � n c o n m � s v e n t a s * * | B u e n o s A i r e s ( $ 3 5 , 8 2 0 - 1 , 0 4 1 � r d e n e s ) |
| * * M � t o d o d e p a g o m � s u s a d o * * | M e r c a d o P a g o ( 2 8 . 7 9 % ) |
| * * C l i e n t e c o n m a y o r g a s t o * * | P i n c h a s S t o l l s t e i n e r ( $ 7 6 0 ) |
* * *
# # =�� M E D I D A S D E S E G U R I D A D
| M e d i d a | I m p l e m e n t a c i � n |
| - - - | - - - |
| * * S Q L I n j e c t i o n * * | ' C o n s u l t a s p a r a m e t r i z a d a s c o n ? |
| * * E x p o s i c i � n d e S Q L * * | ' N o s e e x p o n e S Q L l i b r e a l L L M |
| * * V a l i d a c i � n d e t i p o s * * | ' a s e g u r a r _ i n t ( ) c o n v i e r t e y v a l i d a |
| * * L � m i t e s d e r e s u l t a d o s * * | ' l i m i t e a c o t a d o ( 1 - 2 5 , 1 - 5 0 , 1 - 2 0 ) |
| * * S o l o l e c t u r a * * | ' T o d a s l a s t o o l s u s a n S E L E C T |
| * * M a n e j o d e e r r o r e s * * | ' T r y / e x c e p t e n e j e c u t a r _ s q l |
* * *
# # =��� E S T R U C T U R A D E A R C H I V O S
t e x t =��� M C P - O r q u e s t a c i o n - A g e n t e s / % % % % =��� R E A D M E . m d # E s t e a r c h i v o % % % =��� r e q u i r e m e n t s . t x t # D e p e n d e n c i a s % % % =��� . e n v . e x a m p l e # V a r i a b l e s d e e n t o r n o % % % % =��� n o t e b o o k s / % % % % =��� P l a n t i l l a M C P M u l t i F u e n t e F a s t M C P L a n g C h a i n O p e n A I - d a v i d - y u r i v i l c a . i p y n b % % % % =��� d a t a s e t s / % % % % =��� c l i e n t e s . c s v # 3 2 6 c l i e n t e s % % % % =��� v e n t a s . c s v # 3 , 0 2 9 t r a n s a c c i o n e s % % % % =��� p r o d u c t o s . c s v # 3 8 p r o d u c t o s % % % % =��� c a t e g o r i a s . c s v # 8 c a t e g o r � a s % % % % =��� m e t o d o s \ _ p a g o . c s v # 5 m � t o d o s d e p a g o % % % % =��� d o c s / % % % =��� g u i a - u s u a r i o . m d # G u � a d e t a l l a d a ( e s t e d o c u m e n t o ) % % % =��� a r q u i t e c t u r a . m d # E x p l i c a c i � n t � c n i c a
* * *
# # =��� I N S T A L A C I � N L O C A L ( O P C I O N A L )
S i d e s e a s e j e c u t a r l o c a l m e n t e e n l u g a r d e C o l a b :
b a s h # C l o n a r e l r e p o s i t o r i o g i t c l o n e h t t p s : / / g i t h u b . c o m / t u - u s u a r i o / M C P - O r q u e s t a c i o n - A g e n t e s . g i t c d M C P - O r q u e s t a c i o n - A g e n t e s # C r e a r e n t o r n o v i r t u a l p y t h o n - m v e n v v e n v s o u r c e v e n v / b i n / a c t i v a t e # L i n u x / M a c # v e n v \ S c r i p t s \ a c t i v a t e # W i n d o w s # I n s t a l a r d e p e n d e n c i a s p i p i n s t a l l - r r e q u i r e m e n t s . t x t # C o n f i g u r a r v a r i a b l e s d e e n t o r n o c p . e n v . e x a m p l e . e n v # E d i t a r . e n v c o n t u G R O Q _ A P I _ K E Y # E j e c u t a r e l n o t e b o o k j u p y t e r n o t e b o o k n o t e b o o k s /
* * *
# # =��� r e q u i r e m e n t s . t x t
t x t f a s t m c p > = 0 . 1 . 0 l a n g c h a i n > = 1 . 0 . 0 l a n g c h a i n - m c p - a d a p t e r s > = 0 . 1 . 0 l a n g c h a i n - g r o q > = 1 . 0 . 0 p a n d a s > = 2 . 0 . 0 s q l i t e 3 j u p y t e r > = 1 . 0 . 0
* * *
# # =��� . e n v . e x a m p l e
b a s h # G r o q A P I C o n f i g u r a t i o n G R O Q _ A P I _ K E Y = t u _ a p i _ k e y _ a q u i G R O Q _ M O D E L = l l a m a - 3 . 3 - 7 0 b - v e r s a t i l e # O p c i o n e s d e m o d e l o a l t e r n a t i v a s : # G R O Q _ M O D E L = l l a m a - 3 . 1 - 8 b - i n s t a n t # G R O Q _ M O D E L = m i x t r a l - 8 x 7 b - 3 2 7 6 8 # G R O Q _ M O D E L = g e m m a 2 - 9 b - i t
* * *
# # >��� A P R E N D I Z A J E S C L A V E
1 . * * M C P e s t a n d a r i z a l a c o n e c t i v i d a d * * - U n s e r v i d o r M C P p u e d e s e r v i r a m � l t i p l e s a g e n t e s
2 . * * L a o r q u e s t a c i � n e s r e s p o n s a b i l i d a d d e l a g e n t e * * - M C P c o n e c t a , e l a g e n t e d e c i d e
3 . * * L a s t o o l s d e b e n s e r a t � m i c a s * * - U n a t o o l = u n a c a p a c i d a d d e n e g o c i o
4 . * * L a s e g u r i d a d e s p o r c a p a s * * - S e r v e r v a l i d a , o r q u e s t a d o r c o n t r o l a , p r o m p t g u � a
5 . * * L a t r a z a b i l i d a d e s f u n d a m e n t a l * * - V e r q u � t o o l s u s � e l L L M y p o r q u �
6 . * * G r o q e s u n a a l t e r n a t i v a v i a b l e * * - R � p i d o , e c o n � m i c o y c o n t o o l c a l l i n g
- - -
# # =��� G U � A D E U S U A R I O A D I C I O N A L P A R A C O L A B
# # # =�� E n l a c e d i r e c t o p a r a a b r i r e n C o l a b
E n e l R E A D M E , e l b a d g e d e C o l a b y a e s t � i n c l u i d o :
m a r k d o w n [ ! [ O p e n I n C o l a b ] ( h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m / a s s e t s / c o l a b - b a d g e . s v g ) ] ( h t t p s : / / c o l a b . r e s e a r c h . g o o g l e . c o m / g i t h u b / t u - u s u a r i o / M C P - O r q u e s t a c i o n - A g e n t e s / b l o b / m a i n / n o t e b o o k s / P l a n t i l l a M C P M u l t i F u e n t e F a s t M C P L a n g C h a i n O p e n A I - d a v i d - y u r i v i l c a . i p y n b )
# # # �&� I M P O R T A N T E P A R A C O L A B
1 . R u n t i m e : A s e g � r a t e d e u s a r u n r u n t i m e c o n G P U h a b i l i t a d a
- R u n t i m e �! C h a n g e r u n t i m e t y p e �! T 4 G P U ( r e c o m e n d a d o )
2 . T i e m p o d e e j e c u c i � n : E l n o t e b o o k c o m p l e t o t o m a ~ 3 0 - 4 0 m i n u t o s
3 . G u a r d a r p r o g r e s o : C o l a b g u a r d a a u t o m � t i c a m e n t e e n t u D r i v e
- A r c h i v o �! G u a r d a r u n a c o p i a e n D r i v e
4 . R e c o n e x i � n : S i s e d e s c o n e c t a , v u e l v e a e j e c u t a r d e s d e l a F a s e 3
- L a s v a r i a b l e s s e r e i n i c i a n a l r e c o n e c t a r
5 . C o s t o s : G r o q e s g r a t u i t o , p e r o v e r i f i c a t u l � m i t e d e u s o
- G r a t i s : 3 0 r e q u e s t s / m i n u t o
# # =��� R E F E R E N C I A S
# # # D o c u m e n t a c i � n o f i c i a l
- [ M o d e l C o n t e x t P r o t o c o l - S p e c i f i c a t i o n ] ( h t t p s : / / m o d e l c o n t e x t p r o t o c o l . i o / s p e c i f i c a t i o n / )
- [ M o d e l C o n t e x t P r o t o c o l - A r c h i t e c t u r e ] ( h t t p s : / / m o d e l c o n t e x t p r o t o c o l . i o / d o c s / l e a r n / a r c h i t e c t u r e )
- [ F a s t M C P D o c u m e n t a t i o n ] ( h t t p s : / / g i t h u b . c o m / j l o w i n / f a s t m c p )
- [ L a n g C h a i n M C P A d a p t e r s ] ( h t t p s : / / d o c s . l a n g c h a i n . c o m / o s s / p y t h o n / l a n g c h a i n / m c p )
- [ L a n g G r a p h O v e r v i e w ] ( h t t p s : / / d o c s . l a n g c h a i n . c o m / o s s / p y t h o n / l a n g g r a p h / o v e r v i e w )
- [ G r o q D o c u m e n t a t i o n ] ( h t t p s : / / c o n s o l e . g r o q . c o m / d o c s )
# # # M a t e r i a l d e l c u r s o
- P D F : E s t r a t e g i a s d e I n t e g r a c i � n C E R T I A I A R C H I T E C T O N L I N E 2 0 2 6 I I L I M A
- P D F : G u � a T e � r i c a - O r q u e s t a c i � n d e M C P c o n A g e n t e s
# # =��� N O T A S F I N A L E S
# # # S o b r e e l u s o d e G r o q v s O p e n A I
E s t e l a b o r a t o r i o f u e a d a p t a d o p a r a u s a r G r o q e n l u g a r d e O p e n A I d e b i d o a :
- ' T i e r g r a t u i t o g e n e r o s o p a r a d e s a r r o l l o e d u c a t i v o
- ' I n f e r e n c i a u l t r a r r � p i d a
- ' E x c e l e n t e s o p o r t e p a r a t o o l c a l l i n g
- ' B u e n r e n d i m i e n t o e n e s p a � o l
# # # S o b r e e l d a t a s e t
E l d a t a s e t f u e d i s e � a d o p a r a s i m u l a r u n e - c o m m e r c e r e a l c o n :
- D i s t r i b u c i � n g e o g r � f i c a r e a l i s t a ( 6 r e g i o n e s a r g e n t i n a s )
- V a r i e d a d d e c a t e g o r � a s d e p r o d u c t o s a l i m e n t i c i o s
- M � t o d o s d e p a g o c o m u n e s e n L a t i n o a m � r i c a
- V o l u m e n d e d a t o s a d e c u a d o p a r a a n � l i s i s ( 3 , 0 2 9 t r a n s a c c i o n e s )
# # =�d� D A T O S D E L A U T O R
| C a m p o | V a l o r |
| - - - | - - - |
| N o m b r e | D a v i d Y u r i v i l c a |
| C u r s o | C E R T I A I A R C H I T E C T O N L I N E 2 0 2 6 I I L I M A |
| I n s t i t u c i � n | B S G I n s t i t u t e |
| F e c h a d e e n t r e g a | J u l i o 2 0 2 6 |
# # =��� L I C E N C I A
E s t e p r o y e c t o e s d e u s o e d u c a t i v o p a r a e l c u r s o C E R T I A I A R C H I T E C T O N L I N E 2 0 2 6 I I L I M A d e B S G I n s t i t u t e .
< d i v a l i g n = " c e n t e r " >
=��� " N o s e t r a t a d e d a r ' a c c e s o a t o d o ' a l L L M .
S e t r a t a d e e x p o n e r l a s c a p a c i d a d e s m � n i m a s n e c e s a r i a s ,
b a j o p e r m i s o s e x p l � c i t o s , c o n h e r r a m i e n t a s b i e n d e s c r i t a s ,
e v i d e n c i a v e r i f i c a b l e , a c c i o n e s c o n t r o l a d a s y t r a z a b i l i d a d c o m p l e t a . "
P+ S i e s t e p r o y e c t o t e h a s i d o � t i l , � n o o l v i d e s d a r l e u n a e s t r e l l a e n G i t H u b ! P+
< / d i v >
_ V e r s i � n 1 . 0 - J u l i o 2 0 2 6 _
Установка Orquestacion De Agentes
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/systemyuri/MCP-Orquestacion-AgentesFAQ
Orquestacion De Agentes MCP бесплатный?
Да, Orquestacion De Agentes MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Orquestacion De Agentes?
Нет, Orquestacion De Agentes работает без API-ключей и переменных окружения.
Orquestacion De Agentes — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Orquestacion De Agentes в Claude Desktop, Claude Code или Cursor?
Открой Orquestacion De Agentes на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
wenb1n-dev/SmartDB_MCP
A universal database MCP server supporting simultaneous connections to multiple databases. It provides tools for database operations, health analysis, SQL optim
автор: wenb1n-devPostgres Server
This server enables interaction with PostgreSQL databases through the Model Context Protocol, optimized for the AWS Bedrock AgentCore Runtime. It provides tools
автор: madhurprashPostgres
Query your database in natural language
автор: AnthropicPostgreSQL
Read-only database access with schema inspection.
автор: modelcontextprotocolCompare Orquestacion De Agentes with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории data