Servidor MCP de Twelve Data

Visión general

El servidor MCP de Twelve Data proporciona una integración perfecta con la API de Twelve Data para acceder a los datos del mercado financiero. Permite recuperar series temporales históricas, cotizaciones en tiempo real y metadatos de instrumentos para acciones, pares de divisas y criptomonedas.

Nota: Este servidor se encuentra actualmente en la fase inicial de desarrollo; las características y herramientas pueden evolucionar junto con las actualizaciones de la API de Twelve Data.

Obtención de la clave API

Para utilizar el servidor MCP de Twelve Data, primero debe obtener una clave API de Twelve Data:

1. Visite Registro en Twelve Data.
2. Cree una cuenta o inicie sesión si ya tiene una.
3. Vaya a su panel de control y copie su clave API.

Importante: El acceso a puntos finales o mercados específicos puede variar en función de su plan de suscripción a Twelve Data.

U-tool

u-tool es un router universal basado en IA para la API de Twelve Data que transforma la forma de acceder a los datos financieros. En lugar de navegar por más de 100 puntos finales individuales y documentación compleja, simplemente describa lo que necesita en inglés sencillo.

Cómo funciona: 🧠 Procesamiento del lenguaje natural: Entiende su solicitud en inglés conversacional 🔍 Enrutamiento inteligente: Utiliza la búsqueda vectorial para encontrar los puntos finales más relevantes de todo el catálogo de API de Twelve Data 🎯 Selección inteligente: Aprovecha OpenAI GPT-4o para elegir el método óptimo y generar los parámetros correctos ⚡ Ejecución automática: Llama al endpoint adecuado y devuelve los resultados formateados

Qué puedes preguntar: 📈 "Muéstrame el rendimiento de las acciones de Apple esta semana" 📊 "Calcula el RSI para Bitcoin con un periodo de 14 días" 💰 "Obtén los ratios financieros y el balance de Tesla" 🌍 "Compara los tipos de cambio EUR/USD durante 6 meses" 🏦 "Encuentra los ETF tecnológicos con mejor rendimiento"

Categorías de datos compatibles:

• Datos de mercado y cotizaciones - Indicadores técnicos (más de 100)
• Datos fundamentales y financieros - Divisas y criptomonedas
• Fondos de inversión y ETFs - Calendarios y eventos económicos

Una herramienta para todo el ecosistema de Twelve Data. No requiere documentación API.

Instalación

Con UV (recomendado)

Ejecutar directamente sin instalación local utilizando uvx:

uvx mcp-servidor-doce-datos --help

Mediante pip

Instale el servidor mediante pip:

pip install mcp-servidor-doce-datos python -m mcp_servidor_doce_datos --help

Configuración

Integración con Claude Desktop

Añada uno de los siguientes fragmentos a su claude_desktop_config.json: (1) servidor stdio local configurado con utool

{ "mcpServers": { "twelvedata": { "command": "uvx", "args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-u", "YOUR_OPEN_AI_APIKEY"] } }

(2) servidor stdio local sólo con 10 los endpoints más populares

{ "mcpServers": { "twelvedata": { "command": "uvx", "args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-n", "10"] } }

(3) servidor mcp remoto de doce datos

{ "mcpServers": { "twelvedata-remote": { "command": "npx", "args":    [ "mcp-remote", "https://mcp.twelvedata.com/mcp", "--header", "Authorization:${AUTH_HEADER}", "--header", "X-OpenAPI-Key:${OPENAI_API_KEY}" ], "env": { "AUTH_HEADER": "apikey YOUR_TWELVE_DATA_API_KEY", "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY" } } }

Vea lo fácil que es conectar Claude Desktop a Twelve Data MCP Server:

Integración con VS Code

Configuración automática (con UV)

Configuración manual

Para la configuración manual, añada a su configuración de usuario (JSON):

{ "mcp": { "servers": { "twelvedata": { "command": "uvx", "args": [ "mcp-server-twelve-data", "-k", "YOUR_TWELVE_DATA_API_KEY", "-u", "YOUR_OPENAI_API_KEY" ] } }

Depuración

Utilice el inspector de MCP para solucionar problemas:

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data@latest -k YOUR_TWELVE_DATA_API_KEY

Guía de desarrollo

1. Pruebas locales: Utilice el Inspector MCP como se describe en Depuración.
2. Claude Desktop:: Actualizar claude_desktop_config.json para hacer referencia a las rutas de origen locales.

Uso de Docker

Construya y ejecute el servidor utilizando Docker:

docker build -t mcp-server-twelve-data . docker run --rm mcp-server-twelve-data \ -k YOUR_TWELVE_DATA_API_KEY \ -u YOUR_OPENAI_API_KEY \ -t streamable-http

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Vea el archivo LICENSE para más detalles.