Servidor MCP de Confluence
Un sistema de servidor de protocolo de contexto de modelo para acceder a la API de Confluence. Comuníquese con Confluence utilizando un token de acceso personal. Actúa como un servidor intermediario para acceder a la API de Confluence dentro de la zona VPN.
Configuración del sistema
Este proyecto consta de dos servidores:
- Servidor MCP (server.ts): el servidor principal que se comunica con la API de Confluence y procesa los datos.
- Puerto predeterminado: 3000
- Proporcionar API RESTful
- Procesamiento del protocolo MCP
- Servidor proxy (proxyServer.ts): actúa como un proxy entre el cliente MCP y el servidor MCP.
- Puerto predeterminado: 3001
- Recibe solicitudes de clientes MCP y las reenvía al servidor principal
Esta arquitectura está diseñada para abordar problemas del dominio VPN. El servidor MCP se ejecuta dentro de la VPN y accede a la API de Confluence, mientras que el servidor proxy se ejecuta en un entorno accesible externamente.
función
- Ver una lista de todos los espacios de Confluence
- Ver todas las páginas dentro de un espacio específico
- Recuperar información específica de la página por ID de página
- Crear una nueva página
- Actualizar página existente
Instalación y configuración
Prerrequisitos
- Node.js 16.x o posterior
- Bun 1.0.0 o posterior
instalación
# 저장소 클론
git clone https://github.com/yourusername/confluence-mcp-server.git
cd confluence-mcp-server
# 의존성 설치
bun install
Configuración de variables de entorno
Crea un archivo .env en la raíz de tu proyecto y agrega lo siguiente:
PORT=3000
PROXY_PORT=3001
MCP_SERVER_URL=http://localhost:3000
CONFLUENCE_BASE_URL=https://wiki.musinsa.com
PERSONAL_ACCESS_TOKEN=your_personal_access_token
NODE_ENV=development
ejecución
Entorno de desarrollo
# MCP 서버 실행 (Confluence API와 통신)
bun run dev
# 프록시 서버 실행 (MCP 클라이언트와 통신)
bun run dev:proxy
# MCP 서버 Stdio 모드 실행 (선택 사항)
bun run dev:stdio
Entorno de producción
# 빌드
bun run build
# MCP 서버 실행
bun run serve
# 프록시 서버 실행
bun run serve:proxy
Punto final
Punto final del servidor MCP (puerto predeterminado: 3000)
- POST /mcp : punto final principal que maneja solicitudes MCP.
- GET /mcp/tools - Lista de herramientas disponibles
- GET /api/spaces - Lista todos los espacios
- GET /api/spaces/:spaceKey/pages - Recupera una lista de páginas en un espacio específico
- GET /api/pages/:pageId - Recuperar información sobre una página específica
- POST /api/pages - Crear una nueva página
- PUT /api/pages/:pageId - Actualizar una página
- GET /health - Verificar el estado del servidor
Punto final del servidor proxy (puerto predeterminado: 3001)
- POST /mcp : recibe la solicitud del cliente MCP y la reenvía al servidor MCP.
- GET /tools - Lista de herramientas disponibles
- GET /health - Verificar el estado del servidor proxy
Solución de problemas
Solucionar problemas de la zona VPN
Este proyecto se ha dividido en dos servidores para abordar los problemas de la zona VPN:
- El servidor MCP se ejecuta dentro de la VPN y accede directamente a la API de Confluence.
- Un servidor proxy se ejecuta en un entorno accesible externamente y recibe solicitudes de clientes MCP.
Esta configuración actúa como intermediario en situaciones donde el cliente MCP no puede acceder directamente a la API de Confluence.
Error "Error al obtener espacios: No se puede conectar"
Este error puede deberse a los siguientes problemas:
- Problema con el certificado HTTPS : la verificación del certificado SSL está deshabilitada en entornos de desarrollo, pero se requiere una configuración de certificado adecuada en entornos de producción.
- Problemas de conectividad de red : esto puede deberse a una configuración de firewall o proxy que le impide acceder al servidor Confluence.
- Problema con el token de acceso personal : es posible que el token haya expirado o tenga un formato incorrecto.
Cómo resolverlo
- Asegúrese de que
CONFLUENCE_BASE_URL en su archivo .env sea correcto. - Verifique que su token de acceso personal sea válido.
- Verifique la configuración de su firewall para asegurarse de tener acceso a su servidor Confluence.
- Comuníquese con su administrador de red para verificar los derechos de acceso.
- Asegúrese de que la conexión entre el servidor MCP y el servidor proxy esté configurada correctamente (establezca
MCP_SERVER_URL ).
prueba
# 모든 테스트 실행
bun test
# 특정 테스트 실행
bun test src/test/getSpaces.test.ts
Configuración de distribución
Configuración de distribución recomendada
Para entornos de producción, recomendamos la siguiente configuración de implementación:
- Servidor MCP : se implementa dentro de la VPN o en una red que tiene acceso al servidor Confluence.
- Servidor proxy : implementado en una red accesible para clientes MCP.
Consideraciones de seguridad
- Recomendamos que la comunicación entre el servidor proxy y el servidor MCP se cifre mediante HTTPS.
- Mantenga su token de acceso personal seguro y renuévelo periódicamente según sea necesario.
- En un entorno de producción, agregue un mecanismo de autenticación apropiado para evitar el acceso no autorizado al servidor proxy.
Licencia
Instituto Tecnológico de Massachusetts (MIT)