comsats-timetable-mcp
Enables fetching and analyzing COMSATS University timetables via natural language, bridging Claude Desktop with the live university timetable system.
README
��#� �C�O�M�S�A�T�S� �T�i�m�e�t�a�b�l�e� �M�C�P� �S�e�r�v�e�r� �=��=����
�
�
�
�S�t�u�d�e�n�t�s� �a�t� �C�O�M�S�A�T�S� �A�b�b�o�t�t�a�b�a�d� �t�r�a�d�i�t�i�o�n�a�l�l�y� �h�a�d� �t�o� �m�a�n�u�a�l�l�y� �b�r�o�w�s�e� �C�U�O�n�l�i�n�e�,� �d�i�g� �t�h�r�o�u�g�h� �c�o�m�p�l�e�x� �s�t�a�t�e�f�u�l� �d�r�o�p�d�o�w�n� �m�e�n�u�s�,� �a�n�d� �c�r�o�s�s�-�c�h�e�c�k� �s�e�c�t�i�o�n�s� �o�n�e� �b�y� �o�n�e�.� �T�h�i�s� �M�o�d�e�l� �C�o�n�t�e�x�t� �P�r�o�t�o�c�o�l� �(�M�C�P�)� �s�e�r�v�e�r� �b�r�i�d�g�e�s� �t�h�e� �g�a�p� �b�y� �c�o�n�n�e�c�t�i�n�g� �C�l�a�u�d�e� �D�e�s�k�t�o�p� �d�i�r�e�c�t�l�y� �t�o� �t�h�e� �l�i�v�e� �u�n�i�v�e�r�s�i�t�y� �t�i�m�e�t�a�b�l�e� �s�y�s�t�e�m�,� �a�l�l�o�w�i�n�g� �y�o�u� �t�o� �m�a�n�a�g�e� �a�n�d� �o�p�t�i�m�i�z�e� �y�o�u�r� �s�e�m�e�s�t�e�r� �s�c�h�e�d�u�l�e� �u�s�i�n�g� �n�a�t�u�r�a�l� �l�a�n�g�u�a�g�e�.�
�
�
�
�-�-�-�
�
�
�
�#�#� �=� �S�y�s�t�e�m� �A�r�c�h�i�t�e�c�t�u�r�e�
�
�
�
�T�h�e� �p�r�o�j�e�c�t� �a�c�t�s� �a�s� �a�n� �a�u�t�o�m�a�t�e�d� �m�i�d�d�l�e�w�a�r�e� �l�a�y�e�r� �w�r�a�p�p�i�n�g� �t�h�e� �l�e�g�a�c�y� �A�S�P�.�N�E�T� �W�e�b�F�o�r�m�s� �p�o�r�t�a�l�:�
�
�
�
���`�t�e�x�t�
�
� � � � �C�l�a�u�d�e� �D�e�s�k�t�o�p� �(�A�I� �C�l�i�e�n�t�)�
�
� � � � � � � � � � � � � � � �%
�
� � � � � � � � � � � � � � � ��% � �(�S�t�d�i�o� �P�r�o�t�o�c�o�l�)�
�
� � � � � � � �[� �s�e�r�v�e�r�.�p�y� �]� �(�F�a�s�t�M�C�P� �S�e�r�v�e�r� �D�e�f�i�n�i�t�i�o�n�)�
�
� � � � � � � � � � � � � � � �%
�
� � � � � � � � � � � � � � � ��%
�
� � � � � � � �[� �s�c�r�a�p�e�r�.�p�y� �]� �(�S�t�a�t�e�f�u�l� �3�-�W�a�y� �A�S�P�.�N�E�T� �H�a�n�d�s�h�a�k�e�)�
�
� � � � � � � � � � � � � � � �%
�
� � � � � � � � � � � � � � � ��%
�
� � � � � � � �[� �p�a�r�s�e�r�.�p�y� �]� ��%�%�% �[� �a�n�a�l�y�z�e�r�.�p�y� �]�
�
� � � � �(�H�T�M�L� �E�x�t�r�a�c�t�i�o�n�)� � � � � � �(�Q�u�a�l�i�t�y� �M�e�t�r�i�c�s� �E�n�g�i�n�e�)�
�
� � � � �=���� �R�e�q�u�i�r�e�m�e�n�t�s�
�
�
�
� � � � �P�y�t�h�o�n� �3�.�1�0�+�
�
�
�
� � � � �C�l�a�u�d�e� �D�e�s�k�t�o�p� �A�p�p�l�i�c�a�t�i�o�n�
�
�
�
� � � � �G�i�t�
�
�
�
�=��� �S�e�t�u�p� �&� �I�n�s�t�a�l�l�a�t�i�o�n�
�
�1�.� �C�l�o�n�e� �t�h�e� �R�e�p�o�s�i�t�o�r�y�
�
�
�
�O�p�e�n� �y�o�u�r� �t�e�r�m�i�n�a�l� �o�r� �P�o�w�e�r�S�h�e�l�l� �a�n�d� �r�u�n� �t�h�e� �f�o�l�l�o�w�i�n�g� �c�o�m�m�a�n�d�s� �t�o� �c�l�o�n�e� �t�h�e� �r�e�p�o�s�i�t�o�r�y� �t�o� �y�o�u�r� �l�o�c�a�l� �m�a�c�h�i�n�e�:�
�
�B�a�s�h�
�
�
�
�g�i�t� �c�l�o�n�e� �h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�a�b�b�d�u�l�l�a�h�j�a�n�/�c�o�m�s�a�t�s�-�t�i�m�e�t�a�b�l�e�-�m�c�p�.�g�i�t�
�
�c�d� �c�o�m�s�a�t�s�-�t�i�m�e�t�a�b�l�e�-�m�c�p�
�
�
�
�2�.� �I�n�s�t�a�l�l� �P�y�t�h�o�n� �D�e�p�e�n�d�e�n�c�i�e�s�
�
�
�
�I�n�s�t�a�l�l� �t�h�e� �r�e�q�u�i�r�e�d� �p�a�c�k�a�g�e�s� �f�o�r� �a�s�y�n�c�h�r�o�n�o�u�s� �n�e�t�w�o�r�k� �r�e�q�u�e�s�t�s�,� �H�T�M�L� �p�a�r�s�i�n�g�,� �a�n�d� �t�h�e� �c�o�r�e� �M�C�P� �f�r�a�m�e�w�o�r�k�:�
�
�B�a�s�h�
�
�
�
�p�y�t�h�o�n� �-�m� �p�i�p� �i�n�s�t�a�l�l� �h�t�t�p�x� �b�e�a�u�t�i�f�u�l�s�o�u�p�4� �l�x�m�l� �m�c�p�
�
�
�
�3�.� �V�e�r�i�f�y� �t�h�e� �I�n�s�t�a�l�l�a�t�i�o�n�
�
�
�
�R�u�n� �t�h�e� �s�e�r�v�e�r� �e�n�t�r�y� �p�o�i�n�t� �l�o�c�a�l�l�y� �t�o� �v�e�r�i�f�y� �e�v�e�r�y�t�h�i�n�g� �i�n�i�t�i�a�l�i�z�e�s� �p�r�o�p�e�r�l�y�:�
�
�B�a�s�h�
�
�
�
�p�y�t�h�o�n� �-�u� �s�e�r�v�e�r�.�p�y�
�
�
�
� � � � �=ء� �N�o�t�e�:� �T�h�e� �t�e�r�m�i�n�a�l� �w�i�l�l� �a�p�p�e�a�r� �t�o� �"�h�a�n�g�"� �o�r� �p�a�u�s�e� �s�i�l�e�n�t�l�y�.� �T�h�i�s� �i�s� �e�x�p�e�c�t�e�d� �b�e�h�a�v�i�o�r�!� �T�h�e� �s�e�r�v�e�r� �c�o�m�m�u�n�i�c�a�t�e�s� �e�x�c�l�u�s�i�v�e�l�y� �v�i�a� �S�t�a�n�d�a�r�d� �I�n�p�u�t�/�O�u�t�p�u�t� �(�s�t�d�i�o�)� �c�h�a�n�n�e�l�s�.� �P�r�e�s�s� �C�t�r�l� �+� �C� �t�o� �e�x�i�t�;� �C�l�a�u�d�e� �D�e�s�k�t�o�p� �w�i�l�l� �s�p�a�w�n� �a�n�d� �m�a�n�a�g�e� �t�h�i�s� �l�i�f�e�c�y�c�l�e� �a�u�t�o�m�a�t�i�c�a�l�l�y�.�
�
�
�
�=ػ� �C�o�n�n�e�c�t�i�n�g� �t�o� �C�l�a�u�d�e� �D�e�s�k�t�o�p�
�
�1�.� �I�n�s�t�a�l�l� �C�l�a�u�d�e� �D�e�s�k�t�o�p�
�
�
�
�I�f� �y�o�u� �h�a�v�e�n�'�t� �i�n�s�t�a�l�l�e�d� �t�h�e� �d�e�s�k�t�o�p� �e�n�v�i�r�o�n�m�e�n�t� �y�e�t�:�
�
�
�
� � � � �D�o�w�n�l�o�a�d� �t�h�e� �a�p�p� �f�r�o�m� �c�l�a�u�d�e�.�a�i�/�d�o�w�n�l�o�a�d�.�
�
�
�
� � � � �I�n�s�t�a�l�l� �t�h�e� �a�p�p�l�i�c�a�t�i�o�n� �a�n�d� �s�i�g�n� �i�n� �w�i�t�h� �y�o�u�r� �a�c�c�o�u�n�t�.�
�
�
�
�2�.� �O�p�e�n� �t�h�e� �C�o�n�f�i�g�u�r�a�t�i�o�n� �F�i�l�e�
�
�
�
�O�p�e�n� �C�l�a�u�d�e� �D�e�s�k�t�o�p�,� �c�l�i�c�k� �o�n� �y�o�u�r� �P�r�o�f�i�l�e� �i�c�o�n� �i�n� �t�h�e� �b�o�t�t�o�m�-�l�e�f�t� �c�o�r�n�e�r�,� �g�o� �t�o� �S�e�t�t�i�n�g�s�,� �a�n�d� �c�l�i�c�k� �t�h�e� �b�u�t�t�o�n� �t�o� �o�p�e�n� �o�r� �e�d�i�t� �y�o�u�r� �c�o�n�f�i�g�u�r�a�t�i�o�n� �f�i�l�e� �(�c�l�a�u�d�e��d�e�s�k�t�o�p��c�o�n�f�i�g�.�j�s�o�n�)�.�
�
�
�
�A�l�t�e�r�n�a�t�i�v�e�l�y�,� �n�a�v�i�g�a�t�e� �d�i�r�e�c�t�l�y� �t�o� �t�h�e� �s�y�s�t�e�m� �p�a�t�h�s� �b�e�l�o�w�:�
�
�
�
� � � � �W�i�n�d�o�w�s�:� �%�A�P�P�D�A�T�A�%�\�C�l�a�u�d�e�\�c�l�a�u�d�e��d�e�s�k�t�o�p��c�o�n�f�i�g�.�j�s�o�n�
�
�
�
� � � � �m�a�c�O�S�:� �~�/�L�i�b�r�a�r�y�/�A�p�p�l�i�c�a�t�i�o�n� �S�u�p�p�o�r�t�/�C�l�a�u�d�e�/�c�l�a�u�d�e��d�e�s�k�t�o�p��c�o�n�f�i�g�.�j�s�o�n�
�
�
�
�3�.� �I�n�j�e�c�t� �t�h�e� �S�e�r�v�e�r� �C�o�n�f�i�g�u�r�a�t�i�o�n�
�
�
�
�A�p�p�e�n�d� �t�h�e� �t�i�m�e�t�a�b�l�e�-�m�c�p� �c�o�n�f�i�g�u�r�a�t�i�o�n� �b�l�o�c�k� �i�n�s�i�d�e� �y�o�u�r� �m�c�p�S�e�r�v�e�r�s� �s�e�c�t�i�o�n�.� �M�a�k�e� �s�u�r�e� �t�o� �u�p�d�a�t�e� �t�h�e� �a�b�s�o�l�u�t�e� �p�a�t�h� �t�o� �y�o�u�r� �e�x�a�c�t� �p�r�o�j�e�c�t� �d�i�r�e�c�t�o�r�y� �l�o�c�a�t�i�o�n�:�
�
�W�i�n�d�o�w�s� �E�x�a�m�p�l�e� �(�c�l�a�u�d�e��d�e�s�k�t�o�p��c�o�n�f�i�g�.�j�s�o�n�)�
�
�J�S�O�N�
�
�
�
�{�
�
� � �"�m�c�p�S�e�r�v�e�r�s�"�:� �{�
�
� � � � �"�t�i�m�e�t�a�b�l�e�-�m�c�p�"�:� �{�
�
� � � � � � �"�c�o�m�m�a�n�d�"�:� �"�p�y�t�h�o�n�"�,�
�
� � � � � � �"�a�r�g�s�"�:� �[�
�
� � � � � � � � �"�-�u�"�,�
�
� � � � � � � � �"�D�:�\�\�F�i�e�l�d�\�\�P�r�o�j�e�c�t�s�\�\�C�y�b�e�r�\�\�M�c�p�P�r�o�j�e�c�t�\�\�t�i�m�e�t�a�b�l�e�-�m�c�p�\�\�s�e�r�v�e�r�.�p�y�"�
�
� � � � � � �]�
�
� � � � �}�
�
� � �}�
�
�}�
�
�
�
�m�a�c�O�S� �E�x�a�m�p�l�e� �(�c�l�a�u�d�e��d�e�s�k�t�o�p��c�o�n�f�i�g�.�j�s�o�n�)�
�
�J�S�O�N�
�
�
�
�{�
�
� � �"�m�c�p�S�e�r�v�e�r�s�"�:� �{�
�
� � � � �"�t�i�m�e�t�a�b�l�e�-�m�c�p�"�:� �{�
�
� � � � � � �"�c�o�m�m�a�n�d�"�:� �"�p�y�t�h�o�n�3�"�,�
�
� � � � � � �"�a�r�g�s�"�:� �[�
�
� � � � � � � � �"�-�u�"�,�
�
� � � � � � � � �"�/�U�s�e�r�s�/�Y�o�u�r�N�a�m�e�/�P�r�o�j�e�c�t�s�/�c�o�m�s�a�t�s�-�t�i�m�e�t�a�b�l�e�-�m�c�p�/�s�e�r�v�e�r�.�p�y�"�
�
� � � � � � �]�
�
� � � � �}�
�
� � �}�
�
�}�
�
�
�
� � � � �=ء� �T�i�p�:� �O�n� �W�i�n�d�o�w�s�,� �r�e�m�e�m�b�e�r� �t�o� �u�s�e� �d�o�u�b�l�e� �b�a�c�k�s�l�a�s�h�e�s� �(�\�\�)� �w�i�t�h�i�n� �t�h�e� �p�a�t�h� �a�r�r�a�y� �i�t�e�m�s� �t�o� �p�r�o�p�e�r�l�y� �e�s�c�a�p�e� �J�S�O�N� �s�t�r�i�n�g�s�.�
�
�
�
�4�.� �R�e�l�a�u�n�c�h� �C�l�a�u�d�e�
�
�
�
�F�u�l�l�y� �c�l�o�s�e� �C�l�a�u�d�e� �D�e�s�k�t�o�p� �f�r�o�m� �y�o�u�r� �t�a�s�k�b�a�r� �o�r� �s�y�s�t�e�m� �t�r�a�y� �a�n�d� �r�e�o�p�e�n� �i�t�.� �I�f� �c�o�n�f�i�g�u�r�e�d� �s�u�c�c�e�s�s�f�u�l�l�y�,� �a� �p�l�u�g� �i�c�o�n� �(�=��)� �w�i�l�l� �a�p�p�e�a�r� �i�n�s�i�d�e� �y�o�u�r� �t�e�x�t� �i�n�p�u�t� �b�o�x�,� �i�n�d�i�c�a�t�i�n�g� �t�h�e� �t�i�m�e�t�a�b�l�e� �t�o�o�l�s� �a�r�e� �l�i�v�e�.�
�
�<د� �U�s�a�g�e� �E�x�a�m�p�l�e�s�
�
�
�
�O�n�c�e� �c�o�n�n�e�c�t�e�d�,� �y�o�u� �d�o�n�'�t� �n�e�e�d� �t�o� �w�r�i�t�e� �c�o�d�e� �o�r� �r�u�n� �s�c�r�i�p�t�s� �m�a�n�u�a�l�l�y�.� �S�i�m�p�l�y� �i�n�t�e�r�a�c�t� �w�i�t�h� �C�l�a�u�d�e� �n�a�t�i�v�e�l�y�:�
�
�
�
� � � � �=��� �"�F�e�t�c�h� �t�h�e� �t�i�m�e�t�a�b�l�e� �l�a�y�o�u�t� �f�o�r� �B�C�S� �5�A� �a�n�d� �s�h�o�w� �m�e� �t�h�e� �s�c�h�e�d�u�l�e�.�"�
�
�
�
� � � � �=�
� �"�W�h�a�t� �c�l�a�s�s�e�s� �d�o�e�s� �B�S�E� �4�B� �h�a�v�e� �o�n� �W�e�d�n�e�s�d�a�y� �m�o�r�n�i�n�g�s�?�"�
�
�
�
� � � � ��&� �"�A�n�a�l�y�z�e� �m�y� �s�c�h�e�d�u�l�e� �m�e�t�r�i�c�s� �f�o�r� �B�C�S� �5�A� �a�n�d� �h�i�g�h�l�i�g�h�t� �a�n�y� �e�a�r�l�y� �m�o�r�n�i�n�g� �c�l�a�s�s� �d�i�s�t�r�i�b�u�t�i�o�n�s� �o�r� �h�e�a�v�y� �d�a�y�s�.�"�
�
�
�
�=��� �P�r�o�j�e�c�t� �S�t�r�u�c�t�u�r�e�
�
�P�l�a�i�n�t�e�x�t�
�
�
�
�c�o�m�s�a�t�s�-�t�i�m�e�t�a�b�l�e�-�m�c�p�/�
�
�%
�
�%�%�% �s�e�r�v�e�r�.�p�y� � � � � � �#� �C�o�r�e� �F�a�s�t�M�C�P� �A�p�p�l�i�c�a�t�i�o�n� � �e�x�p�o�s�e�s� �t�o�o�l�s� �t�o� �t�h�e� �L�L�M� �r�u�n�t�i�m�e�
�
�%�%�% �s�c�r�a�p�e�r�.�p�y� � � � � �#� �N�e�t�w�o�r�k� �L�a�y�e�r� � �e�x�e�c�u�t�e�s� �m�u�l�t�i�-�s�t�e�p� �P�O�S�T� �h�a�n�d�s�h�a�k�e�s� �t�o� �b�y�p�a�s�s� �V�i�e�w�S�t�a�t�e� �g�u�a�r�d�s�
�
�%�%�% �p�a�r�s�e�r�.�p�y� � � � � � �#� �D�o�m� �E�x�t�r�a�c�t�i�o�n� � �i�s�o�l�a�t�e�s� �a�n�d� �s�t�r�i�p�s� �m�a�t�r�i�x� �n�o�d�e�s� �o�u�t� �o�f� �r�a�w� �s�e�r�v�e�r� �r�e�s�p�o�n�s�e�s�
�
�%�%�% �a�n�a�l�y�z�e�r�.�p�y� � � � �#� �A�n�a�l�y�t�i�c�s� �L�a�y�e�r� � �c�o�m�p�u�t�e�s� �w�o�r�k�l�o�a�d� �d�e�n�s�i�t�i�e�s� �a�n�d� �f�l�a�g� �p�a�r�a�m�e�t�e�r�s�
�
�%�%�% �R�E�A�D�M�E�.�m�d� � � � � � �#� �D�o�c�u�m�e�n�t�a�t�i�o�n� �A�s�s�e�t�
�
�
�
�=�'� �T�r�o�u�b�l�e�s�h�o�o�t�i�n�g�
�
�
�
� � � � �M�i�s�s�i�n�g� �P�l�u�g� �I�c�o�n� �/� �"�N�o� �T�o�o�l�s� �A�v�a�i�l�a�b�l�e�"�:� �E�n�s�u�r�e� �C�l�a�u�d�e� �D�e�s�k�t�o�p� �w�a�s� �c�o�m�p�l�e�t�e�l�y� �r�e�s�t�a�r�t�e�d� �a�f�t�e�r� �u�p�d�a�t�i�n�g� �t�h�e� �J�S�O�N� �c�o�n�f�i�g� �f�i�l�e�.� �C�h�e�c�k� �y�o�u�r� �W�i�n�d�o�w�s� �S�y�s�t�e�m� �T�r�a�y� �t�o� �v�e�r�i�f�y� �i�t� �w�a�s�n�'�t� �r�u�n�n�i�n�g� �s�i�l�e�n�t�l�y� �i�n� �t�h�e� �b�a�c�k�g�r�o�u�n�d�.�
�
�
�
� � � � �J�S�O�N� �S�y�n�t�a�x� �V�a�l�i�d�a�t�i�o�n� �E�r�r�o�r�s�:� �E�n�s�u�r�e� �y�o�u�r� �c�o�n�f�i�g� �f�i�l�e� �c�o�n�t�a�i�n�s� �v�a�l�i�d� �c�o�m�m�a�s� �s�e�p�a�r�a�t�i�n�g� �t�o�p�-�l�e�v�e�l� �e�l�e�m�e�n�t�s�.� �I�f� �y�o�u� �h�a�v�e� �m�u�l�t�i�p�l�e� �s�e�r�v�e�r�s� �r�u�n�n�i�n�g� �c�o�n�c�u�r�r�e�n�t�l�y�,� �v�e�r�i�f�y� �t�h�a�t� �k�e�y�s� �a�r�e� �d�e�l�i�m�i�t�e�d� �b�y� �c�o�m�m�a�s� �c�l�e�a�n�l�y�.�
�
�
�
� � � � �A�S�P�.�N�E�T� �S�t�a�t�e�f�u�l� �F�a�l�l�i�n�g� �B�a�c�k� �t�o� �B�B�A� �T�i�m�e�t�a�b�l�e�:� �L�e�g�a�c�y� �s�e�r�v�e�r�s� �r�e�l�y� �h�e�a�v�i�l�y� �o�n� �s�e�s�s�i�o�n� �c�o�o�k�i�e�s� �a�n�d� �t�o�k�e�n� �l�i�f�e�c�y�c�l�e�s�.� �I�f� �t�h�e� �d�r�o�p�d�o�w�n� �v�e�r�i�f�i�c�a�t�i�o�n� �s�t�e�p� �m�i�s�s�e�s� �a�n� �e�v�a�l�u�a�t�i�o�n� �t�i�c�k�,� �r�e�-�p�r�o�m�p�t� �C�l�a�u�d�e� �t�o� �f�i�r�e� �t�h�e� �t�o�o�l� �c�a�l�l� �a�g�a�i�n� �t�o� �s�y�n�c�h�r�o�n�i�z�e� �t�h�e� �s�t�a�t�e� �e�n�g�i�n�e�.�
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。