stockmatrix-mcp 0.1.1 → 0.1.3

package/README.md

@@ -129,5 +129,4 @@ MIT
 
 - [Website](https://stockmatrix.co.kr)
 - [Developer Guide](https://stockmatrix.co.kr/developers)
-- [GitHub](https://github.com/MongLong0214/stock-ai-newsletter)
 - [llms.txt](https://stockmatrix.co.kr/llms.txt)

package/dist/fetch-helper.js

@@ -1,4 +1,5 @@
 const BASE_URL = process.env.STOCKMATRIX_API_URL || 'https://stockmatrix.co.kr';
+const MCP_USER_AGENT = `stockmatrix-mcp/0.1.3`;
 // 시작 시 URL 유효성 검증
 try {
     new URL(BASE_URL);
@@ -6,6 +7,22 @@ try {
 catch {
     throw new Error(`Invalid STOCKMATRIX_API_URL: "${BASE_URL}" is not a valid URL`);
 }
+const FETCH_TIMEOUT_MS = 15_000;
+const MAX_RETRIES = 2;
+const RETRY_BASE_MS = 1_000;
+const RETRYABLE_STATUS = new Set([429, 502, 503, 504]);
+const isRetryable = (error) => {
+    if (error instanceof Error) {
+        const msg = error.message;
+        return (msg.includes('ECONNRESET') ||
+            msg.includes('ETIMEDOUT') ||
+            msg.includes('UND_ERR_CONNECT_TIMEOUT') ||
+            msg.includes('fetch failed') ||
+            RETRYABLE_STATUS.has(Number(msg.match(/API request failed: (\d+)/)?.[1])));
+    }
+    return false;
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 export const fetchApi = async (path, params) => {
     const url = new URL(path, BASE_URL);
     if (params) {
@@ -13,30 +30,53 @@ export const fetchApi = async (path, params) => {
             url.searchParams.set(key, value);
         }
     }
-    const response = await fetch(url.toString(), {
-        headers: { Accept: 'application/json' },
-    });
-    if (!response.ok) {
-        const errorText = await response.text().catch(() => 'Unknown error');
-        throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorText}`);
-    }
-    const contentType = response.headers.get('content-type') || '';
-    if (!contentType.includes('application/json')) {
-        const preview = await response.text().catch(() => '');
-        throw new Error(`Expected JSON response but got ${contentType || 'unknown'}: ${preview.slice(0, 200)}`);
-    }
-    const json = (await response.json());
-    if (json !== null &&
-        typeof json === 'object' &&
-        'success' in json &&
-        'data' in json) {
-        const wrapped = json;
-        if (!wrapped.success) {
-            throw new Error(wrapped.error?.message || 'API returned unsuccessful response');
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        if (attempt > 0) {
+            await sleep(RETRY_BASE_MS * 2 ** (attempt - 1));
+        }
+        try {
+            const response = await fetch(url.toString(), {
+                headers: {
+                    Accept: 'application/json',
+                    'User-Agent': MCP_USER_AGENT,
+                },
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => 'Unknown error');
+                throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            const contentType = response.headers.get('content-type') || '';
+            if (!contentType.includes('application/json')) {
+                const preview = await response.text().catch(() => '');
+                throw new Error(`Expected JSON response but got ${contentType || 'unknown'}: ${preview.slice(0, 200)}`);
+            }
+            const json = await response.json();
+            if (json === null || json === undefined) {
+                throw new Error('API returned null or undefined response');
+            }
+            if (typeof json === 'object' &&
+                json !== null &&
+                'success' in json &&
+                'data' in json) {
+                const wrapped = json;
+                if (!wrapped.success) {
+                    throw new Error(wrapped.error?.message || 'API returned unsuccessful response');
+                }
+                return wrapped.data;
+            }
+            return json;
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < MAX_RETRIES && isRetryable(error)) {
+                continue;
+            }
+            throw error;
         }
-        return wrapped.data;
     }
-    return json;
+    throw lastError;
 };
 export const formatResult = (data) => JSON.stringify(data, null, 2);
 export const formatError = (error) => {

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const createSandboxServer: () => McpServer;

package/dist/index.js

@@ -6,15 +6,20 @@ import { registerGetThemeDetail } from './tools/get-theme-detail.js';
 import { registerGetThemeHistory } from './tools/get-theme-history.js';
 import { registerSearchThemes } from './tools/search-themes.js';
 import { registerGetStockTheme } from './tools/get-stock-theme.js';
-const server = new McpServer({
-    name: 'stockmatrix-mcp',
-    version: '0.1.0',
-});
-registerGetThemeRanking(server);
-registerGetThemeDetail(server);
-registerGetThemeHistory(server);
-registerSearchThemes(server);
-registerGetStockTheme(server);
+const createServer = () => {
+    const s = new McpServer({
+        name: 'stockmatrix-mcp',
+        version: '0.1.3',
+    });
+    registerGetThemeRanking(s);
+    registerGetThemeDetail(s);
+    registerGetThemeHistory(s);
+    registerSearchThemes(s);
+    registerGetStockTheme(s);
+    return s;
+};
+export const createSandboxServer = () => createServer();
+const server = createServer();
 const main = async () => {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools/search-themes.js

@@ -5,6 +5,7 @@ export const registerSearchThemes = (server) => {
         query: z
             .string()
             .min(1)
+            .max(200)
             .describe('Search query (theme name or related stock name, e.g. "AI", "반도체", "삼성전자")'),
     }, async ({ query }) => {
         try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stockmatrix-mcp",
   "mcpName": "io.github.MongLong0214/stockmatrix-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "StockMatrix MCP Server - Korean stock market theme lifecycle analysis for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -26,15 +26,7 @@
     "kosdaq",
     "ai-agent"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/MongLong0214/stock-ai-newsletter.git",
-    "directory": "mcp"
-  },
   "homepage": "https://stockmatrix.co.kr/developers",
-  "bugs": {
-    "url": "https://github.com/MongLong0214/stock-ai-newsletter/issues"
-  },
   "license": "MIT",
   "author": "StockMatrix <aistockmatrix@gmail.com>",
   "engines": {