BigKinds MCP Server

A Model Context Protocol (MCP) server for searching Korean news using the BigKinds API.

Features

• 🔍 News Search: Search Korean news articles with various filters
• 📊 Issue Ranking: Get trending news topics and hot issues
• 📈 Keyword Trends: Analyze keyword trends over time
• 🚀 STDIO-based: Works seamlessly with Claude Desktop and other MCP clients

Installation

Via Smithery (Recommended)

npx @smithery/cli install @sedaily/bigkinds-mcp

Via NPM

npm install -g @sedaily/bigkinds-mcp

From Source

git clone https://github.com/sedaily/bigkinds-mcp-server.git
cd bigkinds-mcp-server
npm install
npm run build

Configuration

1. Get BigKinds API Key

1. Visit BigKinds
2. Sign up for an account
3. Go to API Management in your profile
4. Generate an API key

2. Set Environment Variables

Create a .env file:

BIGKINDS_ACCESS_KEY=your-api-key-here
BIGKINDS_API_URL=https://tools.kinds.or.kr

3. Configure Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bigkinds": {
      "command": "npx",
      "args": ["-y", "@sedaily/bigkinds-mcp"],
      "env": {
        "BIGKINDS_ACCESS_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

search_news

Search for Korean news articles.

Parameters:

• query (required): Search keywords
• startDate: Start date (YYYY-MM-DD)
• endDate: End date (YYYY-MM-DD)
• providers: Array of news providers to filter

Example:

Search for "삼성전자" news from last week

get_issue_ranking

Get trending news issues for a specific date.

Parameters:

• date: Target date (YYYY-MM-DD), defaults to today

Example:

What are today's trending news topics?

get_keyword_trend

Analyze keyword trends over time.

Parameters:

• keyword (required): Keyword to analyze
• period: Analysis period ('daily', 'weekly', 'monthly')

Example:

Show me the trend for "AI" over the past month

Development

Testing Locally

# Install dependencies
npm install

# Run in development mode
npm run dev

# Test with MCP Inspector
npm test

Building

npm run build

Troubleshooting

API Key Issues

• Make sure your BigKinds API key is valid
• Check if the key is properly set in environment variables

Connection Issues

• Verify BigKinds API is accessible
• Check your internet connection
• Ensure the API URL is correct

License

MIT

Support

• Issues: GitHub Issues
• Email: mcp@sedaily.com

Credits

Developed by Seoul Economic Daily

Made with ❤️ for the Korean developer community