Servidor de stock MCP global

Servidor de Protocolo de Contexto de Modelo (MCP) para datos y análisis del mercado bursátil global

descripción general

Este proyecto proporciona un servidor MCP para acceder a datos del mercado de valores. Bríndele a su asistente de IA acceso en tiempo real a precios de acciones, datos de gráficos, información de la empresa y más.

¿Qué es MCP (Protocolo de Contexto Modelo)?

El Protocolo de Contexto de Modelo (MCP) es una forma estandarizada para que las aplicaciones proporcionen contexto a los Modelos de Lenguaje Grandes (LLM). Para obtener más información, consulte el sitio web del Protocolo de Contexto Modelo .

función

Obtenga cotizaciones de acciones en tiempo real
Datos y gráficos del historial de acciones
Apoyo a los principales índices bursátiles
Información de la empresa y datos financieros
Implementado en TypeScript y verificación de tipos estricta

Guía del usuario

Prerrequisitos

Node.js 18 y superior
npm o hilo

Cómo instalar

Clonar el repositorio:
git clone https://github.com/sakura-ku/grobal_mcp_stock_server.git cd grobal_mcp_stock_server
Instalar dependencias:
npm install
Construya y ejecute el servidor:
npm run build npm start

Cómo utilizar

1. Configuración de variables de entorno

Primero, configure las variables de entorno necesarias: Cree un archivo .env o copie y use un archivo .env.example existente:

# Windows PowerShellの場合
Copy-Item .env.example .env

# UNIX系システムの場合
cp .env.example .env

Edite el archivo .env para configurar las claves API requeridas:

# 基本設定
PORT=3000
HOST=localhost
NODE_ENV=development

# Polygon.io APIキー (株価データ取得用)
POLYGON_API_KEY=your_polygon_api_key_here

# その他のAPIキー...

2. Ejecución del servidor

Para iniciar el servidor en modo de desarrollo:

npm run dev

Para iniciar el servidor en modo de producción:

npm run build
npm run start:prod

3. Cómo utilizar la API

Acceso directo desde su navegador

Una vez que el servidor esté en funcionamiento, podrá acceder a los datos de stock en su navegador con la siguiente URL:

http://localhost:3000/api/stock/price?symbol=AAPL

Ejemplo usando cURL

Puede recuperar los datos desde la línea de comando usando cURL:

# 株価データの取得
curl "http://localhost:3000/api/stock/price?symbol=AAPL"

# 株価履歴データの取得（過去30日間）
curl "http://localhost:3000/api/stock/history?symbol=AAPL&days=30"

Ejemplo de uso de un programa

Ejemplo de uso de una aplicación Node.js:

// 株価データを取得する関数
async function getStockPrice(symbol) {
  const response = await fetch(`http://localhost:3000/api/stock/price?symbol=${symbol}`);
  const data = await response.json();
  return data;
}

// 使用例
getStockPrice('AAPL').then(data => {
  console.log(`現在の${data.symbol}の株価: ${data.price} ${data.currency}`);
});

4. Integración con asistentes de IA

Consulte la sección "Trabajar con clientes MCP" para obtener información sobre cómo integrarse con asistentes de IA como Claude, GPT-4, etc.

Ejemplo de uso de Claude

Ejemplo del mensaje de Claude:

株価を調べてください。
テスラ（TSLA）の現在の株価と、過去1週間の動向を教えてください。

Ejemplo de respuesta del asistente de IA

テスラ（TSLA）の株価情報は以下の通りです：

現在の株価: $248.42 USD
前日比: +$5.21 (+2.14%)
取引量: 3,421,532株

過去1週間の動向:
- 7日前: $230.15
- 6日前: $232.05
- 5日前: $235.87
- 4日前: $239.14
- 3日前: $242.33
- 2日前: $243.21
- 1日前: $248.42

過去1週間で約8%の上昇トレンドを示しています。特に直近3日間で価格の上昇が加速しています。

Herramientas disponibles

Obtener información sobre el precio de las acciones (get_stock_price)

Obtiene el precio actual de las acciones y la información relacionada con la acción especificada.

Parámetros:

symbol (cadena): símbolo bursátil (p. ej., AAPL, MSFT, GOOGL)

Devoluciones:

Información bursátil (precio, fluctuación, moneda, etc.)

Integración con clientes MCP

Para utilizar este servidor MCP en un cliente (Claude, Claude Desktop u otra aplicación compatible con MCP), cree un archivo mcp.json y defina el servidor MCP.

Ejemplo de definición de mcp.json

A continuación se muestra un ejemplo de una definición mcp.json para usar este servidor. Agregar esta configuración a su cliente MCP le permitirá acceder a cotizaciones de acciones:

{
  "servers": [
    {
      "id": "global-stock-server",
      "url": "http://localhost:3000",
      "description": "株式市場データと分析のためのMCPサーバー",
      "tools": [
        {
          "name": "get_stock_price",
          "description": "指定された株式銘柄の現在の株価と関連情報を取得します",
          "parameters": {
            "type": "object",
            "required": ["symbol"],
            "properties": {
              "symbol": {
                "type": "string",
                "description": "株式銘柄コード（例: AAPL, MSFT, GOOGL）"
              }
            }
          }
        }
      ]
    }
  ]
}

Cómo configurar en el cliente MCP

Guarde la definición mcp.json anterior en algún lugar
Abra la pantalla de configuración de su cliente MCP (como Claude Desktop)
Seleccione la opción "Agregar servidor" o "Importar" en la sección Configuración de MCP
Seleccione el archivo mcp.json que guardó o copie y pegue el contenido
Guarde la configuración y reinicie el cliente.

La herramienta de cotización de acciones ahora estará disponible en los mensajes y chats de su cliente MCP.

Cómo configurar en Cursor IDE

En Cursor IDE, puede hacer que el asistente de IA esté disponible para sus herramientas agregando la configuración del servidor MCP al archivo settings.json.

Procedimiento de configuración

Abra la configuración del cursor:
- Windows/Linux: Ctrl+,
- macOS: Cmd+,
Seleccione “Configuración del cursor” y edite el archivo settings.json.
Agregue lo siguiente a la sección mcpServers :

Si lo ejecuta como un proyecto local (recomendado):

Este proyecto está pensado para ser desarrollado y ejecutado localmente. La forma más confiable de hacerlo es mediante un script npm:

{
  "mcpServers": {
    "global-stock-server": {
      "command": "npm",
      "args": ["run", "start"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "production",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Si está ejecutando en modo de desarrollo:

{
  "mcpServers": {
    "global-stock-server": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "development",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Instalación desde paquetes de GitHub

Este servidor MCP se expone como un registro npm privado mediante paquetes de GitHub. Puedes instalarlo siguiendo estos pasos:

Cree o edite el archivo .npmrc para configurar la autenticación:

@sakura-ku:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}

Establezca la variable de entorno NPM_TOKEN en su token de acceso personal de GitHub:

# Windowsの場合
$env:NPM_TOKEN="your_github_token"

# macOS/Linuxの場合
export NPM_TOKEN="your_github_token"

Instalar el paquete:

npm install @sakura-ku/grobal-mcp-stock-server

Ejemplo de configuración en Cursor IDE:

{
  "mcpServers": {
    "global-stock-server": {
      "command": "npx",
      "args": ["@sakura-ku/grobal-mcp-stock-server"],
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Para obtener instrucciones de configuración detalladas, consulte Cómo administrar un registro npm privado .

solución de problemas

Si el servidor no se inicia :
- Vaya al directorio de su proyecto y ejecute el comando manualmente para ver el error.
- Verifique que las dependencias estén instaladas correctamente (ejecute npm install )
- Comprueba si la versión de TypeScript es correcta
Si no puede encontrar la herramienta :
- Compruebe si el servidor está funcionando correctamente
- Verifique el nombre de la herramienta registrado en la salida del registro
- Si es necesario, ejecute el servidor en modo de depuración con npm run dev

Guía para desarrolladores

Configuración del proyecto

grobal_mcp_stock_server/
├── build/                # コンパイルされたJavaScriptファイル
├── src/
│   ├── __tests__/        # 統合テストとテストユーティリティ
│   ├── config/           # 設定ファイル
│   ├── data/             # データモデルとストレージ
│   ├── errors/           # カスタムエラークラス
│   ├── services/         # 外部APIとの連携サービス
│   ├── tools/            # MCPツール実装
│   │   └── __tests__/    # ツールユニットテスト
│   ├── types/            # TypeScript型定義
│   └── index.ts          # メインサーバーエントリーポイント
├── package.json          # プロジェクト設定
├── tsconfig.json         # TypeScript設定
└── README.md             # プロジェクトドキュメント

Configuración de su entorno de desarrollo

Instalar dependencias de desarrollo:
npm install
Inicie el servidor en modo de desarrollo:
npm run dev

Flujo de trabajo de desarrollo

Inicie el compilador de TypeScript en modo de observación: npm run dev
Análisis estático del código: npm run lint
Solucione automáticamente los problemas de análisis estático: npm run lint:fix
Ejecutar la prueba: npm test

Scripts disponibles

Explicación detallada de los scripts definidos en package.json:

Script de compilación

build : compila el código TypeScript y lo envía al directorio dist.
build:dev : Construye con mapas fuente para el entorno de desarrollo
build:prod : compilación para producción sin mapas de origen
clean : elimina y limpia el directorio dist
prebuild : ejecuta automáticamente el script limpio antes de la compilación

Script de inicio del servidor

start : inicia el servidor compilado
start:dev : inicia el servidor con una configuración de entorno de desarrollo
start:prod : inicia el servidor en una configuración de producción
dev : Modo de desarrollo que vigila los cambios en el código fuente y compila y reinicia automáticamente.

Scripts de control de calidad del código

lint : utiliza ESLint para realizar análisis estático del código TypeScript.
lint:fix : Corrección automática de problemas de código mediante ESLint

Guión de prueba

test : ejecuta todas las pruebas usando Jest
test:watch : Ejecutar pruebas en modo de vigilancia, volver a ejecutarlas cuando haya cambios
test:coverage : Genera un informe de cobertura de prueba
test:ci : Ejecutar con configuración de prueba para entorno CI
test:unit : ejecuta solo pruebas unitarias
test:integration : ejecuta solo pruebas de integración
test:services : ejecuta solo pruebas de servicio
test:debug : ejecuta pruebas en modo de depuración

Implementación y empaquetado

deploy:staging : Implementar en el entorno de ensayo
deploy:production : Implementar en el entorno de producción
publish:package : publica un paquete en el registro npm
prepare:package : ejecuta una compilación de producción antes del empaquetado y crea un archivo tar
prepublishOnly : ejecuta una compilación de producción antes de publicar el paquete

licencia

ISC

contribución

Si está interesado en contribuir a este proyecto, envíe una solicitud de extracción.

Integrations