mcpField
T
TAM-MCP-Server

TAM-MCP-Server

ローカル
github.com/gvaibhavビジネス・マーケティング362 週間前に更新

TAM-MCP-Server について

TAM-MCP-Serverは、TAM/SAMの算出、業界分析、経済データへのアクセスを提供する市場調査サーバーです。ビジネスアナリストや調査チーム向けに、28のツール、15のプロンプト、8つのデータソースを備えています。

主な機能

  1. 01TAM・SAMの算出と予測
  2. 02業界分析と市場セグメント化
  3. 038つの経済データソースに接続
  4. 0415種類のビジネス分析プロンプト
  5. 05STDIO、HTTP、SSEに対応

活用シーン

  1. 01市場規模の推定と成長予測
  2. 02業界や市場機会の比較
  3. 03資金調達や企業戦略の分析準備

MCP 対応

MCP サーバーとして、28の市場調査・データツール、15のビジネスプロンプト、ドキュメントとステータスのリソースをクライアントに公開します。STDIO、Streamable HTTP、SSEに対応しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"TAM-MCP-Server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"build"
]
}
}
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

市場規模分析 MCP サーバー

License TypeScript MCP Version

28 個のツール、15 個のビジネス向けプロンプト、8 つの経済データソースとの連携を通じて、市場調査とビジネス分析の機能を提供する Model Context Protocol サーバーです。

以前は、こちらの公式 MCP コミュニティサーバー一覧に掲載されていました:https://github.com/modelcontextprotocol/servers/blob/e21dbea731f2ccddcd48525cf9a1e1e405fee12f/README.md

概要

この MCP サーバーは、次のような包括的な市場調査機能を提供します。

  • 28 個のツール:市場分析、データアクセス、ビジネスインテリジェンスのためのツール
  • 15 個のプロンプト:資金調達、戦略、調査向けの専門的なビジネス分析テンプレート
  • データ連携:Alpha Vantage、BLS、Census、FRED、IMF、Nasdaq Data Link、OECD、World Bank
  • スマートなデフォルト値:セットアップ不要ですぐに使える、事前設定済みのパラメーター
  • 複数のトランスポート:STDIO、Streamable HTTP、SSE に対応
アーキテクチャの概要
flowchart TD
    Client[MCP Client] <--> Transports

    subgraph Transports[Transports]
        STDIO[STDIO]
        HTTP[HTTP]
        SSE[SSE]
    end

    Transports <--> ToolTiers

    subgraph ToolTiers[MCP Tool Tiers]
        Tier3[Tier 3: Business Analysis Tools]
        Tier2[Tier 2: Basic Market Tools]
        Tier1[Tier 1: Data Access Tools]

        Tier3 --> Tier2
        Tier3 --> Tier1
        Tier2 --> Tier1
    end

    ToolTiers <--> CacheLayer

    subgraph CacheLayer[Cache Layer]
        InMemory[In-Memory Cache]
        Redis[Redis Cache]
    end

    CacheLayer <--> DataServices

    subgraph DataServices[Data Services]
        AV[Alpha Vantage]
        BLS[BLS]
        Census[Census]
        FRED[FRED]
        IMF[IMF]
        Nasdaq[Nasdaq]
        OECD[OECD]
        WB[World Bank]
    end
機能

市場分析ツール

  • 総獲得可能市場(TAM)とサービス可能獲得可能市場(SAM)の算出
  • 市場規模の推定と予測
  • 業界分析と競争インテリジェンス
  • 市場セグメンテーションと機会の特定
  • データ検証と複数ソース間の照合

ビジネスインテリジェンス向けプロンプト

  • スタートアップの資金調達ピッチ準備
  • プライベートエクイティ投資分析
  • 企業戦略と市場参入
  • 危機管理と規制の影響評価
  • ESG とサステナビリティ分析

データアクセス

  • 金融・経済データのリアルタイム取得
  • 複数ソースからのデータ集約と比較
  • データの種類と利用可能性に基づくインテリジェントなルーティング
  • パフォーマンス最適化のための包括的なキャッシュ

MCP プロトコルの機能

  • リアルタイム通知:市場インテリジェンス、データソースの健全性、計算の節目、パフォーマンス監視に関する、ビジネスに特化した 6 種類の通知
  • 複数のトランスポート:STDIO、HTTP、Server-Sent Events(SSE)プロトコルを完全サポート
  • リソースアクセス:MCP リソースを通じて、ドキュメントとステータス情報を利用可能
  • ツールの検出:スマートなデフォルト値と検証機能を備えた、完全なツールカタログ

インストール

前提条件
  • Node.js 20.x 以降
  • npm または yarn
  • データソースの API キー(任意。「設定」を参照)
クイックセットアップ
# Clone repository
git clone https://github.com/your-username/TAM-MCP-Server.git
cd TAM-MCP-Server

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your API keys

# Build and start (HTTP - recommended)
npm run build
npm run start:http
開発環境のセットアップ
# Use development script
chmod +x scripts/dev-setup.sh
./scripts/dev-setup.sh

# Or manual setup
npm install
npm run build
npm run start  # HTTP server
npm run start:stdio  # STDIO transport
Docker でのデプロイ
# Build image
docker build -t tam-mcp-server .

# Run container with environment file
docker run -p 3000:3000 --env-file .env tam-mcp-server

# Or run with individual environment variables
docker run -p 3000:3000 \
  -e ALPHA_VANTAGE_API_KEY=your_key_here \
  -e FRED_API_KEY=your_key_here \
  -e NODE_ENV=production \
  tam-mcp-server
MCP 連携

HTTP トランスポート(推奨) Claude Desktop の場合は、設定に次の内容を追加します。

{
  "mcpServers": {
    "tam": {
      "command": "npm",
      "args": ["run", "start:http"],
      "cwd": "/path/to/TAM-MCP-Server"
    }
  }
}

STDIO トランスポート(代替)

{
  "mcpServers": {
    "tam": {
      "command": "npm",
      "args": ["run", "start:stdio"],
      "cwd": "/path/to/TAM-MCP-Server"
    }
  }
}

MCP Inspector の場合:

# HTTP mode
npm run start:http

# STDIO mode  
npx @modelcontextprotocol/inspector npm run start:stdio

使用方法

スマートなデフォルト値 ― 手間なくすぐに開始

パラメーターを調べることなく、すぐに専門的な市場インサイトを得られます!

28 個すべてのツールには、すぐに分析を開始できるインテリジェントなデフォルト値が設定されています。

// Call any tool with empty parameters - defaults automatically applied
{
  "name": "alphaVantage_getCompanyOverview",
  "arguments": {} // Server provides: symbol="AAPL" (Apple Inc.)
}

{
  "name": "tam_analysis", 
  "arguments": {} // Server provides: $10B market, 15% growth, 5-year projection
}

専門的なデフォルト値の例:

  • 株式分析:AAPL、MSFT、GOOGL(Fortune 500 企業)
  • 経済データ:米国の GDP、世界の指標、2020~2024 年の期間
  • 業界コード:テクノロジー分野、専門サービス(NAICS 54)
  • 市場計算:基準市場規模 100 億ドル、成長率 15%、5 年間の予測

最適な用途:

  • パラメーターを調べずにすぐ結果を得たい初めてのユーザー
  • 専門的な市場分析機能を紹介するデモ環境
  • 現実的なビジネスデータとシナリオを使った迅速なプロトタイピング
基本的なツールの使い方
// Market analysis with defaults
{
  "name": "tam_analysis",
  "arguments": {}
}

// Company overview with default symbol (AAPL)
{
  "name": "alphaVantage_getCompanyOverview", 
  "arguments": {}
}

// Custom parameters
{
  "name": "market_size",
  "arguments": {
    "industryId": "technology",
    "region": "north-america"
  }
}
ビジネス分析向けプロンプト

プロンプトのインターフェースから、専門的なテンプレートにアクセスできます。

// List available prompts
{
  "method": "prompts/list"
}

// Get startup funding prompt
{
  "method": "prompts/get",
  "params": {
    "name": "startup_funding_pitch",
    "arguments": {
      "company_name": "TechCorp",
      "industry": "SaaS"
    }
  }
}
MCP ツール - 3 層アーキテクチャシステム

TAM MCP サーバーは、3 つの相互補完的な階層に整理された合計 28 個の MCP ツールを提供します。

第 1 層:直接データアクセスツール(13 個)

目的:外部データソースへの生データアクセス
対象ユーザー:開発者、データエンジニア、カスタム分析の構築者

  • alphaVantage_getCompanyOverview:企業の詳細な概要と財務情報を取得します
  • alphaVantage_searchSymbols:株式シンボルと企業名を検索します
  • bls_getSeriesData:労働統計局の雇用データを取得します
  • census_fetchIndustryData:米国国勢調査局の業界統計にアクセスします
  • census_fetchMarketSize:国勢調査の調査データから市場規模データを取得します
  • fred_getSeriesObservations:連邦準備制度の経済データ系列を取得します
  • imf_getDataset:国際通貨基金のデータセットにアクセスします
  • imf_getLatestObservation:IMF の最新の経済観測値を取得します
  • nasdaq_getDatasetTimeSeries:Nasdaq Data Link の時系列データを取得します
  • nasdaq_getLatestDatasetValue:Nasdaq のデータセットから最新の値を取得します
  • oecd_getDataset:OECD の統計データセットにアクセスします
  • oecd_getLatestObservation:OECD の最新の経済観測値を取得します
  • worldBank_getIndicatorData:世界銀行の開発指標を取得します
第 2 層:基本的な市場ツール(4 個)

目的:基礎的な市場分析機能
対象ユーザー:基本的な市場調査を始めるビジネスアナリスト

  • industry_search:複数のソースから基本的な業界データを取得します
  • tam_calculator:基本的な獲得可能な最大市場規模(TAM)を計算します
  • market_size_calculator:手法の説明を含む基本的な市場規模の推定
  • company_financials_retriever:基本的な企業財務データを取得します
第 3 層:ビジネス分析ツール(11 個)

目的:高度な市場インテリジェンスと包括的なビジネス分析
対象ユーザー:シニアアナリスト、市場調査担当者、投資チーム

  1. industry_analysis:インテリジェントなランキング機能を備えた、複数のソースを活用する高度な業界分析
  2. industry_data:トレンド、ESG、主要企業を含む詳細な業界インテリジェンス
  3. market_size:信頼度スコアを含む高度な市場規模の推定と分析
  4. tam_analysis:シナリオ予測を含む高度な獲得可能な最大市場規模(TAM)の計算
  5. sam_calculator:制約分析を含むサービス可能な市場規模(SAM)の計算
  6. market_segments:階層型の市場セグメンテーション分析
  7. market_forecasting:シナリオ分析を含む時系列予測
  8. market_comparison:複数市場の比較分析とランキング
  9. data_validation:複数のソースにわたるデータ品質の検証とスコアリング
  10. market_opportunities:市場のギャップと成長機会の特定
  11. generic_data_query:任意のデータソースのサービスやメソッドに直接アクセスします
データソース

サーバーは 8 つのデータソースと連携します。

  • Alpha Vantage:企業財務、株式データ
  • BLS:雇用および労働統計
  • Census:業界および人口統計データ
  • FRED:連邦準備制度の経済データ
  • IMF:国際経済データ
  • Nasdaq Data Link:金融データセット
  • OECD:国際統計
  • World Bank:開発指標
トランスポート方式

HTTP サーバー(推奨)

npm run start:http
# Server available at http://localhost:3000

STDIO トランスポート

npm run start:stdio

サーバー送信イベント

npm run start:sse

設定

環境変数

.env.example を .env にコピーし、必要に応じて設定します。

# Server Configuration
PORT=3000
NODE_ENV=development
LOG_LEVEL=info

# API Keys (Optional - tools work without keys but with limited data)
ALPHA_VANTAGE_API_KEY=your_key_here
CENSUS_API_KEY=your_key_here
FRED_API_KEY=your_key_here
NASDAQ_DATA_LINK_API_KEY=your_key_here
BLS_API_KEY=your_key_here

# Cache Configuration (Optional)
CACHE_TTL_DEFAULT_MS=86400000
CACHE_TTL_ALPHA_VANTAGE_MS=86400000
CACHE_TTL_FRED_MS=86400000
データソースの設定

推奨キー: (注:キーは任意です。キーがない場合、Tier 1 の直接データアクセスツールと、これらの特定のソースに依存する上位ティアの分析ツールは機能が低下し、モックデータまたは制限付きのアクセスに頼ることになります。)

  • Alpha Vantage:無料プランでは1日あたり25リクエストを利用できます
  • Census Bureau:無料の API アクセス
  • FRED:無料の API アクセス
  • Nasdaq Data Link:無料プランを利用できます

キー不要:

  • World Bank、OECD、IMF(公開 API)
  • BLS(上限を引き上げるには任意のキーが必要)
ツールのデフォルト値

すべてのツールには、専門的なデフォルト値が設定されています。パラメーターの一覧については、デフォルト値ガイドを参照してください。

デフォルト値の例:

  • 株式シンボル:AAPL、MSFT、GOOGL
  • 業種コード:NAICS 54(専門サービス)
  • 市場規模:成長率15%を基準とした100億ドル
  • 期間:2020~2024年
キャッシュ戦略

インメモリーキャッシュ(デフォルト)

  • 設定可能な TTL を備えた NodeCache ベース
  • 自動クリーンアップと統計情報
  • ソースごとのキャッシュ無効化

Redis キャッシュ(本番環境)

const dataService = new EnhancedDataService({
  cache: { type: 'redis' },
  apiKeys: { /* your keys */ }
});

プロジェクト構成

TAM-MCP-Server/
├── config/                     # Configuration files
│   ├── jest.config.json       # Jest test configuration  
│   ├── vitest.config.ts       # Vitest test configuration
│   └── redis.conf             # Redis configuration
├── doc/                       # Documentation
│   ├── README.md              # Documentation hub
│   ├── consumer/              # Consumer documentation
│   │   ├── getting-started.md # Getting started guide
│   │   ├── default-values-guide.md # Default values guide
│   │   ├── mcp-prompts-guide.md # MCP prompts guide
│   │   ├── tools-guide.md     # Tools reference
│   │   └── api-reference.md   # API documentation
│   ├── contributor/           # Contributor documentation
│   │   ├── contributing.md    # Development guidelines
│   │   └── security.md        # Security policy
│   ├── reference/             # Reference documentation
│   │   ├── RELEASE-NOTES.md   # Version history
│   │   ├── CHANGELOG.md       # Technical changes
│   │   └── requirements.md    # Technical specifications
│   ├── reports/               # Technical reports and validation
│   │   ├── SEMANTIC-VALIDATION-COMPLETE.md # Validation results
│   │   └── DEFAULT-VALUES-SUMMARY.md # Default values analysis
│   └── archive/               # Historical documents
├── examples/                  # Examples and demos
│   ├── README.md              # Examples documentation
│   ├── demo-default-values.mjs # Default values demonstration
│   ├── demo-integration.mjs   # Integration examples
│   └── TAM-MCP-Server-Postman-Collection.json # API testing
├── scripts/                   # Build and development scripts
│   ├── build.sh               # Production build script
│   ├── dev-setup.sh          # Development environment setup
│   └── dev.sh                # Development helper script
├── src/                       # Source code
│   ├── index.ts               # Main entry point
│   ├── server.ts              # Core MCP server
│   ├── http.ts                # HTTP transport
│   ├── sse-new.ts            # SSE transport
│   ├── stdio-simple.ts       # STDIO transport
│   ├── config/               # Configuration modules
│   ├── services/             # Data source services
│   ├── tools/                # MCP tool implementations
│   ├── prompts/              # Business prompt templates
│   ├── notifications/        # Notification system
│   ├── types/                # TypeScript definitions
│   └── utils/                # Utility functions
├── tests/                     # Test suite
│   ├── unit/                 # Unit tests
│   ├── integration/          # Integration tests
│   ├── e2e/                  # End-to-end tests
│   ├── scripts/              # Test and validation scripts
│   │   ├── test-comprehensive.mjs # Comprehensive testing
│   │   ├── test-semantic-validation.mjs # Semantic validation
│   │   └── *.mjs             # Additional test utilities
│   ├── fixtures/             # Test data and mock objects
│   ├── utils/                # Test utilities and helpers
│   └── setup.ts              # Test configuration
├── logs/                      # Application logs
├── dist/                      # Compiled JavaScript (built)
├── .env.example              # Environment template
├── package.json              # Node.js dependencies
├── tsconfig.json             # TypeScript configuration
└── README.md                 # Main documentation

ツールのリファレンス

MCP データアクセスツール(17個)
直接データソースアクセス(13個)
ソースツール説明
Alpha VantagealphaVantage_getCompanyOverview、alphaVantage_searchSymbols企業の財務情報と株式データ
BLSbls_getSeriesData労働統計局のデータ
Censuscensus_fetchIndustryData、census_fetchMarketSize業種および人口統計データ
FREDfred_getSeriesObservations連邦準備制度の経済データ
IMFimf_getDataset、imf_getLatestObservation国際経済データ
Nasdaqnasdaq_getDatasetTimeSeries、nasdaq_getLatestDatasetValue金融データセット
OECDoecd_getDataset、oecd_getLatestObservation国際統計
World BankworldBank_getIndicatorData開発指標
基本的な市場ツール(4個)
ツール説明
industry_searchソースから基本的な業種データを検索
tam_calculator基本的な総獲得可能市場の計算
market_size_calculator市場規模の推定と計算
company_financials_retriever強化された企業財務データの取得
ビジネス分析ツール(11個)
ツール説明
industry_analysis複数ソースを活用した高度な業種分析
industry_dataトレンドと主要企業を含む詳細な業種インテリジェンス
market_size信頼度スコア付きの高度な市場規模推定
tam_analysis高度な総獲得可能市場の計算
sam_calculatorサービス提供可能市場の分析
market_segments階層型の市場セグメンテーション
market_forecastingシナリオを用いた時系列予測
market_comparison複数市場の比較分析
data_validation複数ソースにわたるデータ品質の検証
market_opportunities市場の空白領域の特定
generic_data_queryデータソースサービスへの直接アクセス
ビジネスプロンプト(15テンプレート)

現実のビジネスシナリオ向けに設計された、専門的なビジネス分析プロンプト15種類:

戦略的ビジネス分析
  • startup_funding_pitch - TAM/SAM分析を含むシリーズ A~C の資金調達プレゼンテーション
  • private_equity_research - PE 案件向けの投資委員会資料
  • corporate_strategy_entry - Fortune 500企業の市場参入戦略分析
  • venture_capital_thesis - VC 投資方針の策定
  • asset_management_research - 機関投資家向け資産運用調査
危機対応と専門分析
  • crisis_management_analysis - 危機対応のための緊急市場分析
  • regulatory_impact_assessment - 規制変更の影響分析
  • international_expansion - グローバル市場参入戦略の分析
  • technology_disruption_analysis - 技術による破壊的変化の影響評価
  • esg_sustainability_analysis - ESG とサステナビリティに関する市場分析
クイック分析とガイダンス
  • market_opportunity_scan - 市場機会の迅速な特定
  • competitive_intelligence - 競争環境の分析
  • investment_screening - 投資機会のスクリーニング
  • tool_guidance - TAM MCP Server ツールのインタラクティブガイド
  • best_practices_guide - 市場分析のベストプラクティス

深い市場インテリジェンスとデータアクセスツールを提供し、ビジネスアナリスト、開発者、市場調査担当者を支援する AI アプリケーション向けに設計されています。

開発

テスト

このプロジェクトでは、主要なテストフレームワークとして Vitest を使用した、包括的なテスト構成を採用しています。

tests/
├── unit/                    # Fast, isolated component tests
├── integration/            # Component interaction tests
├── e2e/                   # End-to-end workflow tests
├── scripts/               # Integration test scripts
│   ├── test-comprehensive.mjs # Comprehensive testing
│   ├── test-http-streaming.mjs # HTTP streaming transport
│   ├── test-simple-mcp.mjs # Basic MCP functionality
│   └── test-mcp-tool-calls.mjs # Individual tool validation
├── fixtures/              # Test data and mock objects
├── utils/                 # Test utilities and helpers
└── setup.ts              # Vitest global configuration
テストの実行
# Run all tests
npm test

# Run by category
npm run test:unit          # Fast unit tests
npm run test:integration   # Integration tests
npm run test:e2e          # End-to-end tests

# Advanced options
npm run test:coverage     # With coverage report
npm run test:watch       # Watch mode for development
npm run test:ui          # Vitest UI mode
npm run test:ci          # CI-optimized test run

# Run integration scripts
npm run test:scripts              # Comprehensive backend integration
npm run test:scripts:http         # HTTP streaming transport  
npm run test:scripts:simple       # Basic MCP functionality
npm run test:scripts:tools        # Individual tool validation
npm run test:scripts:inspector    # MCP Inspector compatibility

# Or run directly
node tests/scripts/test-comprehensive.mjs
node tests/scripts/test-http-streaming.mjs
Postman による API テスト

MCP エンドポイントとバックエンド API 統合の両方をテストするための、包括的な Postman コレクションをインポートしてください。

MCP サーバーのテストコレクション

  1. コレクションをインポート:examples/TAM-MCP-Server-Postman-Collection.json
  2. 環境変数を設定:
  3. テストを実行:
    • ヘルスチェックとサーバーのステータス
    • MCP セッションの初期化
    • 28 個すべてのツール(市場分析 11 個+データアクセス 17 個)
    • リソースアクセスのエンドポイント
    • セッションの管理とクリーンアップ

Newman CLI によるテスト コマンドラインから Postman テストを自動化します。

# Install Newman
npm install -g newman

# Run backend API tests
newman run examples/TAM-MCP-Server-Postman-Collection.json \
  -e tests/postman/environments/TAM-MCP-Server-Environment.postman_environment.json \
  --reporters cli,json

# Or use npm script
npm run test:postman
テストカバレッジ
  • ユニットレベル:個々のツールの機能とビジネスロジック
  • 統合レベル:MCP プロトコルへの準拠とサーバーの動作
  • システムレベル:実際のトランスポートを介した完全なワークフロー
  • API レベル:REST エンドポイントとセッション管理
  • パフォーマンス:応答時間とリソース使用量の監視

コードカバレッジレポートは coverage/ ディレクトリに生成されます。

プロジェクト構成
src/
├── index.ts              # Main entry point
├── server.ts             # MCP server implementation
├── http.ts               # HTTP transport
├── sse-new.ts           # SSE transport
├── stdio-simple.ts      # STDIO transport
├── config/              # Configuration modules
│   └── apiConfig.ts     # API endpoint configurations
├── services/            # Data source services
│   ├── dataService.ts   # Main data orchestrator
│   ├── cache/           # Caching services
│   │   ├── cacheService.ts # In-memory caching
│   │   └── persistenceService.ts # File persistence
│   └── dataSources/     # Individual data source clients
│       ├── alphaVantageService.ts
│       ├── blsService.ts
│       ├── censusService.ts
│       ├── fredService.ts
│       ├── imfService.ts
│       ├── nasdaqDataService.ts
│       ├── oecdService.ts
│       └── worldBankService.ts
├── tools/               # MCP tool implementations
│   └── market-tools.ts  # MarketAnalysisTools class
├── prompts/             # Business prompt templates
├── notifications/       # Notification system
├── types/               # TypeScript definitions
│   ├── index.ts         # Core schemas and types
│   ├── dataSources.ts   # Data source interfaces
│   └── cache.ts         # Cache-related types
└── utils/               # Utility functions
    ├── dataTransform.ts # Data transformation
    ├── envHelper.ts     # Environment parsing
    ├── rateLimit.ts     # Rate limiting
    └── logger.ts        # Winston logging

tests/
├── unit/                # Unit tests
├── integration/         # Integration tests
├── e2e/                 # End-to-end tests
└── scripts/             # Test automation scripts
API テスト

同梱の Postman コレクションを使用してください。

# Import collection
examples/TAM-MCP-Server-Postman-Collection.json

# Or run with Newman
npm run test:postman
技術スタック
  • 言語:TypeScript 5.x
  • プロトコル:MCP 2025-03-26
  • フレームワーク:Express.js 4.x
  • バリデーション:Zod スキーマ
  • テスト:Vitest + Postman
  • キャッシュ:NodeCache(Redis はオプション)
  • ロギング:Winston

トラブルシューティング

よくある問題

API キーを設定しているのにサービスが無効と表示される

  • .env ファイルがプロジェクトのルートにあることを確認してください
  • API キーの変数名が完全に一致していることを確認してください
  • キーを追加した後、サーバーを再起動してください
  • 起動ログにサービスの初期化が表示されていることを確認してください

MCP Inspector の接続に関する問題

  • 次を使用してください:npx @modelcontextprotocol/inspector node dist/stdio-simple.js
  • console.log の出力が stdout に混入していないことを確認してください
  • Winston ロガーが stderr に出力する設定であることを確認してください

ビルドエラー

  • npm install を実行して依存関係を更新してください
  • Node.js のバージョンを確認してください(20.x を推奨)
  • ビルドキャッシュをクリアしてください:rm -rf dist && npm run build

ツールからデータが返されない

  • 起動ログでサービスのステータスを確認してください
  • API のクォータを超過していないことを確認してください
  • generic_data_query ツールでテストしてください
  • ネットワーク接続を確認してください
サポートを受ける

ドキュメント

ドキュメント一式
開発ドキュメント
テストドキュメント
例とスクリプト
実装ガイド
MCP リソースへのアクセス

すべてのドキュメントは MCP プロトコル経由でも利用できます。

// Discover all available documentation
{
  "method": "resources/list",
  "params": {}
}

// Read specific documentation
{
  "method": "resources/read", 
  "params": {
    "uri": "file:///README.md"
  }
}

利用可能なドキュメントリソース:

  • README.md - プロジェクトの概要と機能に関するドキュメント
  • はじめに - クイックセットアップと初回利用の手順
  • 設定ガイド - 環境設定と API キーの管理
  • ツールリファレンス - ツールの詳細なドキュメントと使用例
  • プロンプトガイド - ビジネス分析用プロンプトのテンプレートとシナリオ
  • API リファレンス - API の詳細なドキュメントと統合ガイド
  • セキュリティポリシー - セキュリティガイドラインとベストプラクティス
  • コントリビューションガイド - 開発とコントリビューションに関する手順

コントリビューション

コントリビューションを歓迎します!要件についてはコントリビューションガイドラインをご覧ください。

ライセンス

MIT ライセンスです。詳細はLICENSEファイルをご覧ください。


作成者:Vaibhav Gupta

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。