Global MCP Stock Server

グローバル株式市場データと分析のためのModel Context Protocol (MCP) サーバー

概要

このプロジェクトは、株式市場データにアクセスするためのMCPサーバーを提供します。AI アシスタントが株価、チャートデータ、企業情報などにリアルタイムでアクセスできるようにします。

MCP（Model Context Protocol）とは

Model Context Protocol（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供するための標準化された方法です。詳細は Model Context Protocol ウェブサイト をご覧ください。

功能

• 实时股价信息的获取
• 股价的历史数据和图表
• 主要的股票指标的支持
• 企业信息和财务数据
• TypeScriptによる実装と厳格な型チェック

前提条件

• Node.js 18 以上
• npm または yarn

项目构成

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             # プロジェクトドキュメント

始め方

1. リポジトリをクローンする:

   git clone https://github.com/sakura-ku/grobal_mcp_stock_server.git
   cd grobal_mcp_stock_server
   

2. 依存関係をインストールする:

   npm install
   

3. サーバーをビルドして実行する:

   npm run build
   npm start
   

開発

• TypeScriptコンパイラをウォッチモードで起動: npm run dev
• コードの静的解析: npm run lint
• 静的解析の問題を自動修正: npm run lint:fix
• テストの実行: npm test

利用可能なツール

株価情報の取得 (get_stock_price)

指定された銘柄の現在の株価と関連情報を取得します。

パラメータ:

• symbol (string): 株式の銘柄コード（例: AAPL, MSFT, GOOGL）

戻り値:

• 株価情報（価格、変動、通貨など）

MCPクライアントとの連携

このMCPサーバーをクライアント（Claude, Claude Desktop, その他MCPサポートアプリケーション）で利用するには、mcp.jsonファイルを作成し、MCPサーバーの定義を行います。

mcp.json定義例

以下は、このサーバーを利用するためのmcp.json定義例です。この設定をMCPクライアントに追加することで、株価情報にアクセスできるようになります：

{
  "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）"
              }
            }
          }
        }
      ]
    }
  ]
}

MCPクライアントでの設定方法

1. 上記のmcp.json定義を任意の場所に保存します
2. MCPクライアント（Claude Desktopなど）の設定画面を開きます
3. MCP設定セクションで「サーバー追加」または「インポート」オプションを選択します
4. 保存したmcp.jsonファイルを選択するか、内容をコピー＆ペーストします
5. 設定を保存し、クライアントを再起動します

これで、MCPクライアントのプロンプトやチャット内で株価情報ツールが利用可能になります。

Cursor IDEでの設定方法

Cursor IDEでは、settings.jsonファイルにMCPサーバーの設定を追加することで、AIアシスタントがツールを利用できるようになります。

設定手順

1. Cursorの設定を開きます：

   • Windows/Linux: Ctrl+,
   • macOS: Cmd+,

2. "Cursor Settings"を選択し、settings.jsonファイルを編集します

3. mcpServersセクションに以下の設定を追加します:

ローカルプロジェクトとして実行する場合（推奨）

このプロジェクトはローカルでの開発・実行を前提としています。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"
      }
    }
  }
}

開発モードで実行する場合:

{
  "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"
      }
    }
  }
}

直接コマンドを使用する代替方法

必要に応じて、package.jsonのスクリプトを経由せずに直接コマンドを実行することもできます：

{
  "mcpServers": {
    "global-stock-server": {
      "command": "npx",
      "args": ["-y", "ts-node", "src/index.ts"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "development",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

または、すでにビルド済みのサーバーを使用する場合:

{
  "mcpServers": {
    "global-stock-server": {
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "production",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

GitHub Packagesからインストールする方法

このMCPサーバーはGitHub Packagesを使用してプライベートnpmレジストリとして公開されています。以下の手順でインストールできます：

1. .npmrcファイルを作成または編集して認証設定を行います：

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

2. 環境変数NPM_TOKENにGitHubの個人アクセストークンを設定します：

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

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

3. パッケージをインストールします：

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

4. 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"
      }
    }
  }
}

詳細な設定方法はプライベートnpmレジストリの管理方法をご参照ください。

4. 設定を保存し、Cursorを再起動するか、コマンドパレット（F1）からReload Windowを実行します

5. サーバーの状態は、AIパネルの「MCPサーバー」タブで確認できます：

   • 緑色: サーバーが正常に起動し、利用可能
   • 赤色: サーバーの起動に問題あり（設定とパスを確認）

これで、CursorのAIアシスタントが株価情報ツールを使用できるようになります。プロンプト内で直接「株価情報を取得して」などと指示することができます。

トラブルシューティング

• サーバーが起動しない場合:

  • プロジェクトディレクトリに移動して手動でコマンドを実行し、エラーを確認
  • 依存関係が正しくインストールされているか確認（npm installを実行）
  • TypeScriptのバージョンが合っているか確認

• ツールが見つからない場合:

  • サーバーが正常に起動しているか確認
  • ログ出力で登録されているツール名を確認
  • 必要ならnpm run devでサーバーをデバッグモードで起動

ライセンス

ISC

貢献

このプロジェクトへの貢献に興味がある場合は、プルリクエストを送信してください。

# 全局 MCP 股票服务器

用于全球股票市场数据和分析的 Model Context Protocol (MCP) 服务器

## 概述

本项目提供一个用于访问股票市场数据的 MCP 服务器。它允许 AI 助手实时访问股票价格、图表数据、公司信息等。

## 什么是 MCP（Model Context Protocol）？

Model Context Protocol (MCP) 是一种标准化的方法，用于应用程序向大型语言模型 (LLM) 提供上下文。 更多信息请访问 [Model Context Protocol 网站](https://modelcontextprotocol.github.com/)。

## 功能

- 获取实时股票价格信息
- 股票价格的历史数据和图表
- 支持主要的股票指标
- 企业信息和财务数据
- 使用 TypeScript 实现并进行严格的类型检查

## 前提条件

- Node.js 18 或更高版本
- npm 或 yarn

## 项目结构

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 # 项目文档

## 快速开始

1. 克隆仓库:

   ```bash
   git clone https://github.com/sakura-ku/grobal_mcp_stock_server.git
   cd grobal_mcp_stock_server

2. 安装依赖:

   npm install
   

3. 构建并运行服务器:

   npm run build
   npm start
   

开发

• 在观察模式下启动 TypeScript 编译器: npm run dev
• 代码静态分析: npm run lint
• 自动修复静态分析问题: npm run lint:fix
• 运行测试: npm test

可用工具

获取股票价格信息 (get_stock_price)

获取指定股票代码的当前股票价格和相关信息。

参数:

• symbol (string): 股票代码（例如：AAPL, MSFT, GOOGL）

返回值:

• 股票价格信息（价格、变动、货币等）

与 MCP 客户端集成

要将此 MCP 服务器与客户端（Claude、Claude Desktop 或其他支持 MCP 的应用程序）一起使用，请创建一个 mcp.json 文件并定义 MCP 服务器。

mcp.json 定义示例

以下是用于使用此服务器的 mcp.json 定义示例。 通过将此配置添加到 MCP 客户端，您可以访问股票价格信息：

{
  "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）"
              }
            }
          }
        }
      ]
    }
  ]
}

MCP 客户端配置方法

1. 将上述 mcp.json 定义保存到任意位置
2. 打开 MCP 客户端（例如 Claude Desktop）的设置界面
3. 在 MCP 设置部分选择“添加服务器”或“导入”选项
4. 选择保存的 mcp.json 文件或复制并粘贴内容
5. 保存设置并重新启动客户端

现在，您可以在 MCP 客户端的提示或聊天中使用股票价格信息工具。

Cursor IDE 配置方法

在 Cursor IDE 中，您可以通过将 MCP 服务器的设置添加到 settings.json 文件中，使 AI 助手能够使用该工具。

配置步骤

1. 打开 Cursor 的设置：

   • Windows/Linux: Ctrl+,
   • macOS: Cmd+,

2. 选择 "Cursor Settings" 并编辑 settings.json 文件

3. 将以下设置添加到 mcpServers 部分：

作为本地项目运行时（推荐）

此项目旨在用于本地开发和运行。 使用 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"
      }
    }
  }
}

在开发模式下运行时：

{
  "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"
      }
    }
  }
}

使用直接命令的替代方法

如果需要，您可以直接运行命令，而无需通过 package.json 中的脚本：

{
  "mcpServers": {
    "global-stock-server": {
      "command": "npx",
      "args": ["-y", "ts-node", "src/index.ts"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "development",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者，如果您已经使用了构建好的服务器：

{
  "mcpServers": {
    "global-stock-server": {
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/grobal_mcp_stock_server",
      "env": {
        "PORT": "3000",
        "HOST": "localhost",
        "NODE_ENV": "production",
        "STOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

从 GitHub Packages 安装的方法

此 MCP 服务器使用 GitHub Packages 作为私有 npm 注册表发布。 您可以通过以下步骤安装它：

1. 创建或编辑 .npmrc 文件以配置身份验证设置：

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

2. 将 GitHub 个人访问令牌设置为环境变量 NPM_TOKEN：

# Windows
$env:NPM_TOKEN="your_github_token"

# macOS/Linux
export NPM_TOKEN="your_github_token"

3. 安装软件包：

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

4. 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"
      }
    }
  }
}

有关详细的配置方法，请参阅 私有 npm 注册表的管理方法。

4. 保存设置，然后重新启动 Cursor 或从命令面板（F1）运行 Reload Window

5. 您可以在 AI 面板的“MCP 服务器”选项卡中查看服务器的状态：

   • 绿色：服务器已成功启动并可用
   • 红色：服务器启动有问题（检查设置和路径）

现在，Cursor 的 AI 助手可以使用股票价格信息工具。 您可以直接在提示中指示“获取股票价格信息”等。

故障排除

• 如果服务器未启动:

  • 导航到项目目录并手动运行命令以检查错误
  • 检查是否已正确安装依赖项（运行 npm install）
  • 检查 TypeScript 版本是否正确

• 如果找不到工具:

  • 检查服务器是否已成功启动
  • 检查日志输出中注册的工具名称
  • 如果需要，请使用 npm run dev 在调试模式下启动服务器

许可证

ISC

贡献

如果您有兴趣为此项目做出贡献，请提交拉取请求。