bit101-mcp
BIT101 MCP
Un servicio local de solo lectura Model Context Protocol (MCP) para estudiantes de la Universidad de Tecnología de Beijing. Convierte el contenido de la comunidad BIT101, las evaluaciones de cursos, el horario personal, las calificaciones y el calendario Lexue en datos estructurados fáciles de entender para los agentes, de modo que puedas hacer preguntas directamente en lenguaje natural.
[!IMPORTANT] Este proyecto es un proyecto comunitario no oficial y no tiene afiliación con la Universidad de Tecnología de Beijing ni con BIT101 oficial. Windows ha sido probado en hardware real para los flujos principales, y Fedora 43 + niri ha sido verificado como funcional; el proyecto aún se encuentra en fase MVP. Antes de usarlo, lee Autenticación, seguridad y privacidad.
Qué puede hacer
Resumir las publicaciones de BIT101 de hoy, o buscar discusiones históricas por palabras clave
Consultar cursos, profesores y evaluaciones de estudiantes de años anteriores
Obtener el horario de hoy, esta semana, la próxima semana o de un semestre específico
Consultar calificaciones, créditos, promedio de la clase y puntuación máxima (cuando el proveedor los proporcione)
Consultar eventos del calendario Lexue para un período futuro
Combinar datos de diferentes fuentes para responder preguntas, por ejemplo: "¿Cómo evalúa la gente a los profesores de mis cursos del próximo semestre?"
Todas las herramientas son de solo lectura. El proyecto no puede publicar, dar me gusta, comentar, enviar tareas, modificar calificaciones ni alterar ningún dato escolar.
Related MCP server: MCP-Server-CollageAI
Demostración en hardware real
Las siguientes capturas de pantalla provienen de llamadas reales desde OpenCode CLI en Windows. Las respuestas específicas son generadas por el modelo utilizado según los datos devueltos por MCP y no representan las opiniones del autor del proyecto, y pueden cambiar según el modelo y las actualizaciones de datos.
Resumen de publicaciones de hoy
El agente llama a list_today_posts para obtener las publicaciones del día y luego genera un breve resumen según el título, el contenido y la interacción.

Evaluaciones de profesores y cursos
El agente primero busca los cursos correspondientes al profesor y luego llama a get_course_reviews para agregar metadatos del curso, puntuaciones, comentarios e información histórica.

Discusión sobre orientación profesional
Cuando la biblioteca de cursos no tiene una coincidencia exacta, el agente puede continuar buscando publicaciones de BIT101 y leer discusiones relevantes, lo que demuestra el uso encadenado de múltiples herramientas MCP.

Calendario Lexue
El agente puede consultar eventos de Lexue dentro de 7 a 90 días. Cuando un calendario válido no tiene tareas próximas, devuelve normalmente una lista vacía en lugar de interpretar erróneamente "no hay tareas" como una falla de la interfaz.

Preparación antes del uso
Entorno recomendado actualmente:
Windows 10/11, o Linux con navegador de escritorio y keyring del sistema disponible (Fedora 43 + niri probado)
Python 3.11 o superior
Un cliente compatible con MCP stdio local, como Codex, OpenCode, Cursor o Claude Code
Cuenta de BIT101
Para consultar horarios y calificaciones, también se necesita una cuenta de autenticación unificada de la Universidad de Tecnología de Beijing; algunos inicios de sesión pueden requerir verificación por SMS
Para consultar Lexue, es necesario exportar una vez una dirección de suscripción de calendario privada desde Lexue
Instalación
Dile a tu agente (recomendado)
Si tu agente puede ejecutar comandos de terminal y modificar su propia configuración de MCP, puedes enviarle directamente el siguiente texto:
请帮我安装并配置 BIT101 MCP:
https://github.com/tiny-paris/BIT101-mcp
要求:
1. 先阅读仓库 README,尤其是“认证、安全与隐私”部分,并告诉我它会访问哪些服务。
2. 检查本机是否安装 Python 3.11+、Git 和 uv;缺少时说明后再安装。
3. 优先使用以下命令安装为用户级工具:
uv tool install "git+https://github.com/tiny-paris/BIT101-mcp.git"
4. 识别我当前使用的 MCP 客户端,将 bit101-mcp 配置为用户级/全局 stdio MCP,
名称使用 bit101,单次工具执行超时至少设置为 360 秒。
5. 如果找不到命令,运行 uv tool dir --bin,并在 MCP 配置中使用
bit101-mcp(Windows 为 bit101-mcp.exe)的绝对路径。
6. 重启或重新加载 MCP,验证服务器已连接并能列出工具。
7. 不要在聊天、命令行参数、配置文件或环境变量中向我索要或写入账号、密码、
短信验证码、Cookie、token 或乐学订阅 URL。需要认证时,只让我在 MCP 自动打开的
127.0.0.1 临时页面中操作。
8. 不要修改默认上游地址。完成后告诉我修改了哪些配置文件以及验证结果。Una vez que el agente complete la instalación, simplemente pregunta en una nueva conversación "resume las publicaciones de BIT101 de hoy" para activar la primera autenticación bajo demanda.
Instalación desde el código fuente
Una vez que el repositorio sea público, puedes ejecutar:
git clone https://github.com/tiny-paris/BIT101-mcp.git
cd BIT101-mcp
uv sync --all-groups
uv tool install .uv tool install . instalará bit101-mcp como un comando a nivel de usuario. Puedes ver el directorio de ejecutables de uv con el siguiente comando:
uv tool dir --binSi el cliente MCP no encuentra bit101-mcp, reinicia el cliente, o usa la ruta absoluta de bit101-mcp.exe en ese directorio en la configuración.
Ejecutar solo dentro del directorio del código fuente
Para desarrollo o pruebas, también puedes ejecutar sin instalar el comando:
uv sync --all-groups
uv run bit101-mcpDespués de iniciarse normalmente, el MCP stdio espera silenciosamente mensajes de protocolo; que parezca "congelado" es normal. No lo uses como un comando interactivo normal ni introduzcas nombre de usuario o contraseña en su terminal.
[!NOTE] El soporte simple de
uvx bit101-mcpsolo estará disponible después de que el proyecto se publique en PyPI. El README actual no asume que el paquete de PyPI ya exista.
Notas sobre dependencias
El proyecto declara 7 dependencias directas en tiempo de ejecución. No todas son "requisitos obligatorios del protocolo MCP", sino que son los componentes que cada funcionalidad completa necesita actualmente:
Dependencia | Uso en el proyecto | ¿Se puede eliminar actualmente? |
| Servidor MCP stdio, registro de herramientas, contexto y tipos de protocolo | No; es la dependencia principal |
| Cliente HTTPS asíncrono/síncrono para acceder a BIT101, BIT-Login y el calendario Lexue | No; todos los datos y la autenticación requieren red |
| Guarda sesiones y la dirección de suscripción de Lexue en el almacén de credenciales del sistema operativo | No; sin ella no se pueden reutilizar sesiones de forma segura entre procesos |
| Valida y analiza el ICS/iCalendar exportado de Lexue | No; la funcionalidad de Lexue y la importación al inicio la usan |
| Expande las reglas de recurrencia (RRULE) en el calendario Lexue | No; los eventos periódicos la necesitan |
| Rangos de parámetros de herramientas MCP y esquema JSON, como cantidad de publicaciones, desplazamiento de semanas, días de consulta | No; el código fuente la usa directamente y el SDK de MCP también se basa en ella |
| Proporciona la base de datos de zona horaria | No recomendado eliminar; de lo contrario, algunos entornos Windows/Python no pueden calcular correctamente "hoy" y la semana lectiva |
Por lo tanto, para la versión actual de paquete único, estas 7 son dependencias de ejecución; pero desde el punto de vista funcional, icalendar y python-dateutil solo sirven a Lexue. Si en el futuro se dividen como funcionalidad opcional, podrían convertirse en dependencias adicionales. Dividirlas ahora aumentaría la complejidad de instalación y de informes de errores, y el espacio ahorrado sería muy limitado.
En uv.lock también verás dependencias indirectas como anyio, httpcore, certifi, etc. Son traídas automáticamente por las bibliotecas anteriores, no son componentes de nivel superior invocados directamente por el proyecto, y no deben instalarse ni eliminarse manualmente por separado.
Las siguientes dependencias solo se usan para desarrollo y publicación, y no se instalan como dependencias de ejecución normales:
Dependencia | Uso |
| Pruebas automatizadas |
| Revisión y formato de código |
| Construcción de paquetes fuente y wheel |
Configurar el cliente MCP
La primera autenticación escolar puede tardar varios minutos, por lo que se recomienda establecer el tiempo de espera de una sola llamada de herramienta en 360 segundos. Después de la configuración, es necesario reiniciar el cliente MCP para que inicie un nuevo proceso de servicio.
Codex
Codex CLI, la extensión de Codex para IDE y el host de Codex en el escritorio de ChatGPT comparten la configuración de MCP en config.toml. La documentación oficial está en Documentación de MCP de Codex.
Primero agrégalo a través de la CLI:
codex mcp add bit101 -- bit101-mcp
codex mcp listLuego revisa el %USERPROFILE%\.codex\config.toml a nivel de usuario y añade el tiempo de espera de herramientas:
[mcp_servers.bit101]
command = "bit101-mcp"
tool_timeout_sec = 360Si solo quieres habilitarlo en un proyecto de confianza, puedes poner la misma configuración en el .codex/config.toml de ese proyecto. La configuración a nivel de usuario se puede usar en cualquier directorio y en nuevas conversaciones.
Si el comando no está en el PATH de Codex, puedes cambiar a la ruta absoluta:
[mcp_servers.bit101]
command = 'C:\path\to\bit101-mcp.exe'
tool_timeout_sec = 360OpenCode
Este proyecto ha sido probado en hardware real en Windows con la siguiente configuración tradicional de OpenCode. Colocarlo en opencode.json en la raíz del proyecto solo afecta a ese proyecto; si deseas usarlo en cualquier directorio, colócalo a nivel de usuario en ~/.config/opencode/opencode.json (en Windows normalmente corresponde a %USERPROFILE%\.config\opencode\opencode.json).
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"bit101": {
"type": "local",
"command": ["bit101-mcp"],
"enabled": true,
"timeout": 360000
}
}
}Verificar la conexión:
opencode mcp listSi solo se puede iniciar en el directorio del código fuente, normalmente es porque la configuración usa un comando relativo y no se instaló globalmente. Instala bit101-mcp, o cambia command a la ruta absoluta de .venv\Scripts\bit101-mcp.exe.
La estructura de configuración de OpenCode V2 es diferente: los servicios están en mcp.servers y el tiempo de espera de ejecución en mcp.timeout.execution. Consulta la documentación oficial de MCP de OpenCode:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"timeout": {
"execution": 360000
},
"servers": {
"bit101": {
"type": "local",
"command": ["bit101-mcp"]
}
}
}
}Cursor
Según la documentación de MCP de Cursor, la configuración global va en ~/.cursor/mcp.json y la configuración del proyecto en .cursor/mcp.json:
{
"mcpServers": {
"bit101": {
"command": "bit101-mcp",
"args": []
}
}
}Después de guardar, reinicia Cursor y confirma que bit101 está habilitado en la lista de herramientas disponibles del agente.
Claude Code
Según la documentación de MCP de Claude Code, agrega un servicio stdio a nivel de usuario:
claude mcp add --scope user bit101 -- bit101-mcp
claude mcp listConfiguración stdio genérica
Otros clientes MCP solo necesitan configurar un proceso stdio local:
{
"command": "bit101-mcp",
"args": []
}No escribas nombre de usuario, contraseña, cookies, tokens ni URL de Lexue en la configuración de MCP, variables de entorno o parámetros de herramientas.
Comenzar a usar
Después de la configuración, simplemente pregunta directamente en la conversación del agente; no es necesario iniciar servicios en segundo plano manualmente. Por ejemplo:
Comunidad y cursos de BIT101
总结一下今天 BIT101 都有哪些帖子。
查找最近关于“数据结构”的讨论。
如何评价某某老师的某门课?请区分普遍评价和少数意见。
查找“特立自动化”相关讨论,并列出信息来源。Horarios y calificaciones
我今天有什么课?
我下周有什么课?按实际日期和开始时间排序。
列出本学期完整课表。
列出我的所有成绩,包括课程、学期、学分、成绩、班级平均分和最高分。Al preguntar por "esta semana/próxima semana", el servidor calcula la semana exacta según la fecha actual y devuelve tiempos completos como starts_at, ends_at; el agente no necesita adivinar la semana lectiva ni los horarios de las clases.
Lexue
未来 14 天有哪些乐学任务?按截止时间排序。
看看未来 30 天的乐学日历。Herramientas disponibles
Herramienta | Función | Autenticación requerida |
| Obtiene las publicaciones de BIT101 del día en la zona horaria de Shanghái | BIT101 |
| Busca publicaciones de BIT101 | BIT101 |
| Lee una publicación específica e información relacionada | BIT101 |
| Busca cursos y profesores | BIT101 |
| Agrega información de cursos, profesores, comentarios y cursos históricos | BIT101 |
| Obtiene las clases de hoy | Autenticación unificada escolar |
| Obtiene el horario con fechas de esta semana, la próxima o semanas relativas | Autenticación unificada escolar |
| Obtiene el horario completo del semestre actual o de un semestre específico | Autenticación unificada escolar |
| Obtiene calificaciones y estadísticas de clase disponibles | Autenticación unificada escolar |
| Analiza eventos del calendario Lexue de los próximos 1 a 90 días | Autenticación escolar + dirección de suscripción de Lexue |
Los resultados exitosos tienen un formato uniforme:
{
"ok": true,
"data": {}
}Los resultados fallidos no incluyen trazas de pila del proveedor ni información de autenticación:
{
"ok": false,
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"service": "bit101",
"message": "BIT101 is temporarily unavailable.",
"retryable": true
}
}Principios técnicos
El núcleo se divide en cuatro capas:
Capa de herramientas MCP: solo expone conceptos de usuario como publicaciones, cursos, horarios, calificaciones y tareas; no expone cookies, tokens de desafío ni identificadores de servicios internos.
Capa de clientes: maneja por separado la API de BIT101 y la pasarela de datos escolares; cuando una solicitud falla, determina si la sesión ha expirado y realiza solo un reintento recuperable.
Capa de estandarización: convierte los diferentes formatos de los proveedores en campos estables y compatibles con JSON; se encarga del análisis de fechas en la zona horaria de Shanghái, semanas lectivas, horarios de clases, calificaciones y eventos ICS.
Capa de autenticación y almacenamiento: abre una página local solo cuando es necesario; las contraseñas no entran en los parámetros de MCP; después del éxito, solo se guarda la sesión reutilizable.
MCP usa transporte stdio. La salida estándar solo envía datos del protocolo MCP; los registros de ejecución solo se escriben en el error estándar, evitando que los registros corrompan la comunicación del protocolo.
Flujo de autenticación
¿Por qué no se puede reutilizar directamente el inicio de sesión de BIT101 en el navegador?
Las cookies del navegador pertenecen al espacio de seguridad del propio navegador; MCP es un proceso local independiente. El proyecto deliberadamente no lee la base de datos de cookies de Chrome/Edge ni requiere la instalación de extensiones de navegador. Esto implica una autenticación inicial adicional, pero evita que MCP escanee todas las credenciales del navegador del usuario.
Abrir una nueva conversación de agente no borra el estado de inicio de sesión. Al iniciarse, MCP lee y verifica las sesiones guardadas; solo se vuelve a iniciar sesión si la sesión no existe, el proveedor la considera inválida, el desafío temporal de la pasarela de autenticación ha expirado, o el almacén de credenciales del sistema no está disponible.
BIT101
En la primera llamada a una herramienta de la comunidad:
MCP inicia una página temporal en un puerto aleatorio de
127.0.0.1.El usuario introduce su número de estudiante y la contraseña de BIT101 en la página local.
El proceso local procesa la contraseña según el protocolo de inicio de sesión existente de BIT101 y solicita la API de BIT101 mediante HTTPS.
Después de un inicio de sesión exitoso, solo se guarda la sesión de BIT101 devuelta en el administrador de credenciales del sistema; la contraseña original no se persiste.
La página temporal se cierra y la llamada de herramienta original continúa ejecutándose.
Horarios y calificaciones escolares
Los horarios y calificaciones provienen de la capacidad de datos personales de la escuela y no son la misma "llave" que la sesión de la comunidad BIT101. En la primera llamada, la página local recopila la cuenta de autenticación unificada, la contraseña y, si es necesario, el código de verificación por SMS, y los envía mediante HTTPS a la pasarela REST de BIT-Login existente. MCP guarda la sesión de desafío a corto plazo devuelta por la pasarela, no la contraseña escolar.
Calendario Lexue
La pasarela REST de BIT-Login actual no proporciona una interfaz de calendario Lexue que este proyecto pueda invocar, y el proyecto no reimplementa el CAS/SSO escolar. Por lo tanto, el MVP requiere que el usuario genere una dirección de suscripción privada en la página Calendario → Exportar calendario de Lexue y la pegue una vez en la página de conexión local.
La página de conexión descarga y verifica realmente el contenido iCalendar; solo una suscripción válida muestra Connected; las páginas normales de calendar/view.php son rechazadas. La dirección de suscripción no entra en los resultados del agente ni de las herramientas MCP, y se guarda en el administrador de credenciales del sistema. Un calendario válido sin eventos próximos devuelve una lista vacía.
Autenticación, seguridad y privacidad
Conclusión primero
Este proyecto reduce el riesgo de que las contraseñas entren en el agente, el historial de chat y los registros, pero no puede prometer "riesgo cero". Instalar un MCP local equivale a instalar un programa local con acceso a red; el usuario debe confiar en el código fuente del proyecto, los paquetes de instalación, las dependencias y los servicios de autenticación remotos configurados.
Especialmente hay que distinguir dos afirmaciones:
Las contraseñas no se envían al agente/LLM: es un límite implementado explícitamente por este proyecto.
Las contraseñas solo existen en esta máquina: no es así. La contraseña de autenticación unificada escolar debe ser enviada por el MCP local mediante HTTPS a la pasarela BIT-Login remota configurada para completar la autenticación.
¿Qué información va a dónde?
Información | Quién la toca | ¿Se persiste? |
Contraseña de BIT101 | Código de autenticación local; se envía a la API de BIT101 después de procesarse según el protocolo del proveedor | No se guarda la contraseña |
Contraseña de autenticación unificada escolar | Código de autenticación local y la pasarela BIT-Login configurada | No se guarda |
Código de verificación por SMS | Código de autenticación local y la pasarela BIT-Login | No se guarda |
Sesión de BIT101/escolar | MCP local y el proveedor correspondiente | Almacén de credenciales del sistema operativo |
Dirección de suscripción privada de Lexue | MCP local y el servicio de calendario de | Almacén de credenciales del sistema operativo |
Publicaciones, cursos, horarios, calificaciones, eventos de Lexue | MCP y el agente actual | Entra en el contexto del agente actual |
Las direcciones de proveedores por defecto son:
API de BIT101:
https://bit101.flwfdd.xyzREST de BIT-Login:
https://login.bit101.flwfdd.xyz
HTTPS puede prevenir la interceptación general en la red, pero no sustituye la confianza en el operador del servidor. Los usuarios que no se sientan cómodos con que la contraseña escolar pase por una pasarela remota no deberían habilitar las herramientas de horarios y calificaciones.
Protecciones implementadas
El servicio HTTP temporal solo se vincula a
127.0.0.1, usando un puerto aleatorio asignado por el sistema operativo.Cada autenticación usa un state aleatorio de 256 bits y se compara en tiempo constante para resistir envíos falsificados.
La página desactiva caché, contenido externo, iframes, referrer y adivinación de MIME.
La página deja de escuchar después de éxito, cancelación o tiempo de espera.
Las contraseñas y códigos de verificación no se escriben en archivos; el código limpia las referencias a las variables relevantes lo antes posible después de la solicitud.
Las sesiones se escriben mediante el
keyringde Python en el almacén de credenciales del sistema operativo (Administrador de credenciales de Windows, o el backend de Secret Service/keyring en Linux); si no está disponible, solo se guardan en memoria del proceso actual, sin recurrir a archivos en texto plano.Los registros enmascaran contraseñas, códigos de verificación, cookies, tokens Bearer y cabeceras Authorization.
La dirección de Lexue debe usar HTTPS bajo el dominio
bit.edu.cny debe devolver un iCalendar válido.Todas las herramientas están marcadas como de solo lectura; no proporcionan capacidad de modificar datos escolares o de la comunidad.
Lo que el usuario debe tener en cuenta
Instala solo desde repositorios o páginas de publicación de confianza, y verifica el código fuente y los hashes de publicación siempre que sea posible.
La dirección de la página de autenticación local debe comenzar con
http://127.0.0.1:<puerto aleatorio>/connect.Nunca envíes contraseñas, códigos de verificación, cookies, tokens ni URL de Lexue en el cuadro de chat del agente, parámetros de MCP, issues o registros.
No uses cuentas escolares personales en computadoras públicas no confiables.
La URL de suscripción de Lexue es un enlace privado "quien lo tiene puede leerlo"; protégela como una contraseña; si sospechas que se ha filtrado, regenérala en Lexue.
Al consultar calificaciones y horarios, los datos correspondientes se proporcionan al agente actual. Decide si habilitarlo según la política de datos del modelo y cliente que uses.
Limpiar sesiones locales
En Windows, abre Panel de control → Administrador de credenciales → Credenciales de Windows; en Linux, abre la herramienta de gestión de Secret Service del entorno de escritorio actual (comúnmente GNOME Keyring o KDE Wallet). Elimina las siguientes entradas con el nombre de servicio bit101-mcp:
bit101-sessionschool-sessionlexue-calendar-url
Después de eliminarlas, la siguiente llamada a la herramienta correspondiente volverá a autenticarse. Desinstalar el paquete de Python no elimina automáticamente estas credenciales del sistema. Si Linux no tiene un backend de keyring disponible, las sesiones solo se guardan en la memoria del proceso actual y será necesario volver a iniciar sesión al reiniciar MCP.
Opciones de configuración
Solo se permiten parámetros no secretos mediante variables de entorno:
Variable | Valor por defecto | Uso |
|
| Dirección raíz de la API de BIT101 |
|
| Dirección raíz de REST de BIT-Login |
|
| Tiempo de espera de una sola solicitud HTTP al proveedor, en segundos |
|
| Tiempo máximo de espera de la página de autenticación local, en segundos |
Las credenciales y sesiones no se pueden configurar mediante parámetros de herramientas ni variables de entorno. Modificar las direcciones de los proveedores implica confiar en nuevos operadores de servicios; úsalo con precaución.
Preguntas frecuentes
¿Es obligatorio iniciar el agente en el directorio del proyecto?
No. Después de instalar el comando con uv tool install . y escribir el MCP en la configuración a nivel de usuario del cliente, se puede usar desde cualquier directorio. El opencode.json, .cursor/mcp.json o .codex/config.toml en la raíz del proyecto solo afectan al proyecto correspondiente.
¿Por qué se abre el navegador la primera vez?
La autenticación se activa bajo demanda. La primera consulta de publicaciones requiere la sesión de BIT101; la primera consulta de horarios/calificaciones requiere la sesión escolar; la primera consulta de Lexue también requiere la suscripción de calendario privada. Las contraseñas y la dirección de suscripción no pueden pasar por el chat, por lo que se usa una página local temporal para recopilarlas.
¿Por qué MCP sigue pidiendo iniciar sesión si ya estoy conectado en la página web de BIT101?
La sesión web se guarda en las cookies del navegador. MCP no lee las cookies del navegador, por lo que necesita establecer su propia sesión mínima. Esto sacrifica la conveniencia del primer inicio de sesión, pero evita acceder directamente a todos los datos de inicio de sesión del navegador.
¿Por qué a veces hay que volver a iniciar sesión en una conversación nueva?
Una conversación nueva no borra activamente la sesión, pero MCP verifica la sesión del proveedor. Se vuelve a iniciar sesión cuando la sesión expira, el servidor la revoca, el desafío de la pasarela de autenticación caduca, o el almacén de credenciales del sistema no está disponible. Si acabas de iniciar sesión con éxito y al reiniciar inmediatamente vuelve a pedirla, verifica si existen entradas de bit101-mcp en el almacén de credenciales del sistema.
Lexue muestra Connected, ¿por qué no hay tareas?
Si la dirección de suscripción pasó la verificación iCalendar, una lista vacía normalmente significa que realmente no hay eventos en el rango de tiempo seleccionado. Puedes ampliar el rango de consulta de 7 días a 30 días para confirmarlo.
¿Por qué las herramientas escolares parecen lentas?
La primera autenticación escolar, la verificación por SMS y la obtención de detalles de calificaciones pueden tardar bastante. Establece el tiempo de espera de las herramientas MCP en 360 segundos y espera a que la llamada actual termine; no reintentes varias herramientas escolares simultáneamente.
¿Qué hago si no se encuentra el comando bit101-mcp?
Ejecuta uv tool dir --bin para encontrar el directorio de instalación, añádelo al PATH, o escribe directamente la ruta absoluta de bit101-mcp.exe en la configuración de MCP. Después de modificar, reinicia el cliente.
Códigos de error
Código | Significado |
| Es necesario establecer una sesión de BIT101 |
| Es necesario establecer una sesión escolar |
| La sesión guardada ha expirado |
| El inicio de sesión no tuvo éxito o las credenciales no fueron aceptadas por el proveedor |
| Tiempo de espera de la página de autenticación local agotado |
| La suscripción de Lexue no existe, está caducada o no es un calendario válido |
| El registro especificado (como una publicación) no existe |
| El servicio del proveedor está temporalmente no disponible; se puede reintentar más tarde |
| El proveedor devolvió datos no reconocibles |
Todos los errores se limpian; no se devuelven contraseñas, cookies, tokens, cabeceras Authorization, trazas de pila originales ni solicitudes sensibles completas.
Desarrollo
Estructura del proyecto:
src/bit101_mcp/
├── server.py # MCP 入口、工具注册和服务器说明
├── tools/ # Agent 可见的只读工具
├── clients/ # BIT101 与学校上游客户端
├── auth/ # 本地浏览器认证、状态机和凭据存储
├── models/ # 数据标准化、周次和 ICS 解析
└── logging_utils.py # stderr 日志和秘密脱敏Instalar dependencias de desarrollo y ejecutar verificaciones:
uv sync --all-groups
uv run ruff check .
uv run ruff format --check .
uv buildAntes de publicar, los mantenedores usan pruebas simuladas que no se distribuyen con el repositorio público para verificar la estandarización de datos, el estado de autenticación, el enmascaramiento de secretos y el flujo de reintentos; estas pruebas no requieren cuentas reales. Las pruebas de integración con cuentas reales se mantienen manuales y opcionales; no se deben enviar credenciales de prueba al repositorio ni a CI.
Agradecimientos
Gracias al proyecto BIT101 y a todos sus contribuyentes. La comunidad, las evaluaciones de cursos, las interfaces de datos del campus y las herramientas de autenticación mantenidas durante mucho tiempo por los estudiantes de cursos anteriores han traído gran comodidad a la vida universitaria de los estudiantes y han proporcionado una base importante para este proyecto.
Este proyecto hace referencia o utiliza especialmente las interfaces y documentación de los siguientes proyectos:
BIT101 MCP es un cliente MCP no oficial desarrollado de forma independiente que interactúa con los servicios relacionados a través de interfaces de red. La Licencia MIT de este repositorio solo se aplica al código original de este proyecto y no sustituye ni modifica las licencias de ningún proyecto upstream.
Limitaciones actuales
Windows ha sido probado en hardware real para los flujos principales; Fedora 43 + niri ha sido verificado como funcional; otros entornos de escritorio Linux aún no se han verificado uno por uno.
Lexue aún requiere pegar manualmente una vez la dirección de suscripción de calendario privada exportada.
La validez de la sesión escolar la determina la pasarela del proveedor; no se puede garantizar un inicio de sesión permanente sin reautenticación.
El promedio y la puntuación máxima de las calificaciones dependen de si el proveedor proporciona los detalles de cada curso.
Aún no se han publicado el paquete de PyPI ni el ejecutable independiente para Windows.
No se proporciona ninguna operación de escritura.
Licencia
Este proyecto utiliza la Licencia MIT. Se permite usar, modificar, distribuir y enviar mejoras siempre que se conserven los avisos de copyright y licencia.
Contribuciones
Se aceptan Issues y Pull Requests. Al informar de un problema, proporcione:
Versión del sistema operativo, Python, uv y del cliente MCP
Nombre de la herramienta utilizada y códigos de error anonimizados
Si aparece la página de autenticación local
Pasos para reproducir el problema
No envíe números de identificación de estudiante, contraseñas, códigos de verificación, cookies, tokens, cabeceras de solicitud completas, URL de 乐学 ni otra información personal.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables University of Toronto students to access academic data from ACORN and Quercus via AI assistants. It provides tools to retrieve course schedules, enrollment details, syllabi, assignments, and announcements.
- FlicenseNot gradedqualityCmaintenanceProvides tools for querying student academic data such as subjects, marks, performance reports, timetable, exams, fees, events, holidays, and assignments via natural language.
- AlicenseAqualityAmaintenanceProvides read-only access to StudyLife data including courses, notes, sessions, and learning goals, enabling MCP clients to query study information via natural language.7AGPL 3.0
- FlicenseAqualityCmaintenanceProvides read-only access to Canvas LMS, enabling users to view active courses, grades, and upcoming assignments through natural language queries.2
Related MCP Connectors
Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Read-only access to your VortexIQ store data: audits, KPIs, alerts, Brand DNA, reports, Ask VIQ.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tiny-paris/BIT101-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server