MCP OpenFEC Server

Servidor MCP OpenFEC

Un servidor de Protocolo de Contexto Modelo (MCP) que proporciona acceso a los datos de financiamiento de campañas de la Comisión Federal Electoral (FEC) a través de la API OpenFEC.

Características

• Busque candidatos por nombre, estado o cargo
• Obtenga información detallada del candidato y datos financieros
• Información del comité de acceso
• Ver contribuciones individuales
• Seguimiento de gastos independientes
• Acceda a los archivos de la FEC y a los casos de auditoría
• Descargar datos masivos

Requisitos

• Node.js (v16 o superior)
• Una clave API de OpenFEC ( obtenga una aquí )

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Cree un archivo .env en el directorio raíz y agregue su clave API de OpenFEC:

4. Construir el servidor:

Configuración

Para utilizar este servidor MCP con Claude Desktop:

1. Localice el archivo de configuración de Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Agregue la siguiente configuración al archivo:

Notas de configuración importantes:

1. Reemplace /absolute/path/to/mcp-openfec con la ruta real donde clonó el repositorio
2. Utilice rutas absolutas, no relativas
3. Establezca disabled en false para habilitar el servidor
4. Mantenga autoApprove como una matriz vacía por seguridad
5. Agregue su clave API de OpenFEC en la sección env

Herramientas disponibles

1. get_candidate : Obtener información detallada sobre un candidato
2. get_candidate_financials : Obtener datos financieros de un candidato
3. search_candidates : Busca candidatos por nombre u otros criterios
4. get_committee : Obtener información detallada sobre un comité
5. get_candidate_contributions : Obtener contribuciones individuales de un candidato
6. get_filings : Recuperar archivos oficiales de la FEC
7. get_independent_expenditures : Obtener gastos independientes
8. get_electioneering : Obtener comunicaciones electorales
9. get_party_coordinated_expenditures : Obtener los gastos coordinados del partido
10. get_communication_costs : Obtener los costos de comunicación corporativos/sindicales
11. get_audit_cases : Obtener casos de auditoría y hallazgos de la FEC
12. get_bulk_downloads : Obtener enlaces a descargas masivas de datos

Limitación de velocidad

El servidor implementa la limitación de velocidad para cumplir con las pautas de la API de OpenFEC:

• 1000 solicitudes por hora
• Las solicitudes que excedan este límite recibirán una respuesta de error.

Desarrollo

Para modificar el servidor:

1. Realizar cambios en los archivos TypeScript en el directorio src
2. Reconstruir el servidor:

Licencia

Este proyecto está licenciado bajo la Licencia BSD de 3 Cláusulas, una licencia permisiva de código abierto que garantiza la máxima libertad para los usuarios, manteniendo al mismo tiempo los requisitos de atribución. Esta licencia permite:

• Utilice el código comercialmente
• Modificar el código
• Distribuir el código
• Utilice el código de forma privada

Con tres condiciones principales:

1. Debe incluir el aviso de derechos de autor original.
2. Debes incluir el texto de la licencia en las distribuciones
3. No se pueden utilizar los nombres de los colaboradores para respaldar productos derivados sin permiso.

La licencia BSD de 3 cláusulas se utiliza ampliamente en entornos académicos y comerciales y ofrece un buen equilibrio entre permisividad y protección de los colaboradores.

Contribuyendo

1. Bifurcar el repositorio
2. Crea tu rama de funciones ( git checkout -b feature/my-new-feature )
3. Confirme sus cambios ( git commit -am 'Add some feature' )
4. Empujar a la rama ( git push origin feature/my-new-feature )
5. Crear una nueva solicitud de extracción

Derechos de autor

Copyright (c) 2025, Phillip Salzman & Foundry Peak, LLC. Todos los derechos reservados. Web: http://foundrypeak.com/

Para obtener detalles sobre la licencia, consulte el archivo LICENCIA .