全球 MCP 库存服务器
用于全球股票市场数据和分析的模型上下文协议 (MCP) 服务器
概述
该项目提供了一个用于访问股票市场数据的 MCP 服务器。让您的 AI 助手实时访问股票价格、图表数据、公司信息等。
什么是 MCP（模型上下文协议）？
模型上下文协议 (MCP) 是应用程序为大型语言模型 (LLM) 提供上下文的标准化方式。有关详细信息，请参阅模型上下文协议网站。
功能
- 获取实时股票报价
- 股票历史数据和图表
- 支持主要股票指数
- 公司信息和财务数据
- 使用 TypeScript 实现并进行严格类型检查
用户指南
先决条件
- Node.js 18 及以上版本
- npm 或 yarn
如何安装
- 克隆存储库：
git clone https://github.com/sakura-ku/grobal_mcp_stock_server.git
cd grobal_mcp_stock_server
- 安装依赖项：
- 构建并运行服务器：
如何使用
1.设置环境变量
首先，设置必要的环境变量：创建一个.env文件或复制并使用现有的.env.example文件：
# Windows PowerShellの場合
Copy-Item .env.example .env
# UNIX系システムの場合
cp .env.example .env
编辑.env文件以设置所需的 API 密钥：
# 基本設定
PORT=3000
HOST=localhost
NODE_ENV=development
# Polygon.io APIキー (株価データ取得用)
POLYGON_API_KEY=your_polygon_api_key_here
# その他のAPIキー...
2.运行服务器
以开发模式启动服务器：
以生产模式启动服务器：
npm run build
npm run start:prod
3. 如何使用 API
通过浏览器直接访问
服务器运行后，您可以通过以下 URL 在浏览器中访问股票数据：
http://localhost:3000/api/stock/price?symbol=AAPL
使用 cURL 的示例
您可以使用 cURL 从命令行检索数据：
# 株価データの取得
curl "http://localhost:3000/api/stock/price?symbol=AAPL"
# 株価履歴データの取得（過去30日間）
curl "http://localhost:3000/api/stock/history?symbol=AAPL&days=30"
程序使用示例
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. 与人工智能助手的整合
有关如何与 Claude、GPT-4 等 AI 助手集成的信息，请参阅“使用 MCP 客户端”部分。
Claude 使用示例
克劳德的提示示例：
株価を調べてください。
テスラ（TSLA）の現在の株価と、過去1週間の動向を教えてください。
AI助手响应示例
テスラ（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日間で価格の上昇が加速しています。
可用工具
获取股票价格信息（get_stock_price）
获取指定股票的当前股价及相关信息。
参数：
symbol （字符串）：股票代码（例如 AAPL、MSFT、GOOGL）
返回：
与 MCP 客户端集成
要在客户端（Claude、Claude Desktop 或其他 MCP 支持的应用程序）中使用此 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 客户端上设置
- 将上述 mcp.json 定义保存在您选择的位置。
- 打开 MCP 客户端（例如 Claude Desktop）的设置屏幕
- 在 MCP 设置部分中选择“添加服务器”或“导入”选项
- 选择您保存的 mcp.json 文件或复制并粘贴内容
- 保存设置并重启客户端
股票报价工具现在将在您的 MCP 客户端提示和聊天中可用。
如何在 Cursor IDE 中设置
在 Cursor IDE 中，您可以通过将 MCP 服务器设置添加到 settings.json 文件来使 AI 助手可用于您的工具。
设置程序
- 打开光标设置：
- Windows/Linux：
Ctrl+, - macOS：
Cmd+,
- 选择“光标设置”并编辑settings.json文件。
- 将以下内容添加到
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"
}
}
}
}
从 GitHub Packages 安装
该 MCP 服务器使用 GitHub Packages 公开为私有 npm 注册表。您可以按照以下步骤进行安装：
- 创建或编辑
.npmrc文件来配置身份验证：
@sakura-ku:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${NPM_TOKEN}
- 将
NPM_TOKEN环境变量设置为您的个人 GitHub 访问令牌：
# Windowsの場合
$env:NPM_TOKEN="your_github_token"
# macOS/Linuxの場合
export NPM_TOKEN="your_github_token"
- 安装软件包：
npm install @sakura-ku/grobal-mcp-stock-server
- 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 注册表。
故障排除
- 如果服务器没有启动：
- 进入你的项目目录并手动运行命令来查看错误
- 验证依赖项是否正确安装（运行
npm install ） - 检查 TypeScript 版本是否正确
- 如果找不到该工具：
- 检查服务器是否正常运行
- 检查日志输出中注册的工具名称
- 如果需要，使用
npm run dev以调试模式运行服务器
开发者指南
项目配置
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 # プロジェクトドキュメント
设置开发环境
- 安装开发依赖项：
- 以开发模式启动服务器：
开发工作流程
- 以监视模式启动 TypeScript 编译器：
npm run dev - 代码静态分析：
npm run lint - 自动修复静态分析问题：
npm run lint:fix - 运行测试：
npm test
可用脚本
package.json中定义的脚本详细解释：
构建脚本
build ：编译 TypeScript 代码并将其输出到 dist 目录。build:dev ：使用源映射构建开发环境build:prod ：无需源映射即可进行生产构建clean ：删除并清理 dist 目录prebuild ：在构建之前自动运行清理脚本
服务器启动脚本
start ：启动编译的服务器start:dev ：使用开发环境配置启动服务器start:prod ：以生产配置启动服务器dev ：开发模式，监视源代码的变化并自动构建和重新启动。
代码质量控制脚本
lint ：使用 ESLint 对 TypeScript 代码进行静态分析。lint:fix ：使用 ESLint 自动修复代码问题
测试脚本
test ：使用 Jest 运行所有测试test:watch ：在监视模式下运行测试，在发生更改时重新运行test:coverage ：生成测试覆盖率报告test:ci ：使用 CI 环境的测试配置运行test:unit ：仅运行单元测试test:integration ：仅运行集成测试test:services ：仅运行服务测试test:debug ：以调试模式运行测试
部署和打包
deploy:staging ：部署到暂存环境deploy:production ：部署到生产环境publish:package ：将包发布到 npm 注册表prepare:package ：在打包之前运行生产构建并创建 tarballprepublishOnly ：在发布包之前运行生产构建
执照
国际学习中心
贡献
如果您有兴趣为该项目做出贡献，请提交拉取请求。