# Presidential Speech Records MCP Server
Access Korean presidential speech records from the Presidential Archives
## Overview
This MCP server provides access to the 대통령기록관 연설문 API from Korea's data.go.kr portal through the Model Context Protocol.
## Installation
### Via PyPI
```bash
pip install data-go-mcp.presidential-speeches
```
### Via UV
```bash
uvx data-go-mcp.presidential-speeches
```
## Configuration
### Getting an API Key
1. Visit [data.go.kr](https://www.data.go.kr)
2. Sign up for an account
3. Search for "대통령기록관 연설문" API
4. Apply for API access
5. Get your service key from the API management page
### Environment Setup
Set your API key as an environment variable:
```bash
export API_KEY="your-api-key-here"
```
### Claude Desktop Configuration
Add to your Claude Desktop configuration file:
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"data-go-mcp.presidential-speeches": {
"command": "uvx",
"args": ["data-go-mcp.presidential-speeches@latest"],
"env": {
"API_KEY": "your-api-key-here"
}
}
}
}
```
## Available Tools
### list_speeches
List presidential speeches from the archives.
**Parameters:**
- `page` (int, optional): Page number (default: 1)
- `per_page` (int, optional): Results per page (default: 10)
- `use_2023_version` (bool, optional): Use 2023 version API (default: True)
**Example Usage:**
- "List the latest presidential speeches"
- "Show me 20 presidential speeches from page 2"
### search_speeches
Search presidential speeches with various filters.
**Parameters:**
- `president` (str, optional): Filter by president name
- `title` (str, optional): Search by speech title keyword
- `year` (int, optional): Filter by speech year
- `location` (str, optional): Filter by speech location
- `page` (int, optional): Page number (default: 1)
- `per_page` (int, optional): Results per page (default: 10)
**Example Usage:**
- "Search for speeches by 노무현"
- "Find speeches about 통일 (unification)"
- "Show speeches from 2020"
- "Find speeches delivered at 청와대"
### get_recent_speeches
Get recent presidential speeches.
**Parameters:**
- `president` (str, optional): Filter by president name
- `limit` (int, optional): Number of speeches to retrieve (default: 5)
**Example Usage:**
- "Show me the 10 most recent presidential speeches"
- "Get the latest speeches by 윤석열"
## Response Format
Each speech record contains:
- `id`: Speech identifier (구분번호)
- `president`: President name (대통령)
- `title`: Speech title (글제목)
- `year` or `date`: Speech year or date (연설연도/연설일자)
- `source_url`: Link to full text (원문보기)
- `location`: Speech location (연설장소)
## Development
### Setup
```bash
# Clone the repository
git clone https://github.com/your-org/data-go-mcp-servers.git
cd data-go-mcp-servers/src/presidential-speeches
# Install dependencies
uv sync
```
### Testing
```bash
# Run tests
uv run pytest tests/
# Run with coverage
uv run pytest tests/ --cov=data_go_mcp.presidential_speeches
```
### Running Locally
```bash
# Set your API key
export API_KEY="your-api-key"
# Run the server
uv run python -m data_go_mcp.presidential_speeches.server
```
## API Documentation
For detailed API documentation, visit: https://api.odcloud.kr/api/15084167/v1
## License
Apache License 2.0
## Contributing
Contributions are welcome! Please see the [main repository](https://github.com/your-org/data-go-mcp-servers) for contribution guidelines.
Raw data
{
"_id": null,
"home_page": null,
"name": "data-go-mcp.presidential-speeches",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "api, data.go.kr, korea, mcp, presidential-speeches",
"author": "Data.go.kr MCP Servers Contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/3b/00/9b4434f5d96e88f4ee3abe58092403084ab55130cad8a2f30eb0c818b8e7/data_go_mcp_presidential_speeches-0.1.0.tar.gz",
"platform": null,
"description": "# Presidential Speech Records MCP Server\n\nAccess Korean presidential speech records from the Presidential Archives\n\n## Overview\n\nThis MCP server provides access to the \ub300\ud1b5\ub839\uae30\ub85d\uad00 \uc5f0\uc124\ubb38 API from Korea's data.go.kr portal through the Model Context Protocol.\n\n## Installation\n\n### Via PyPI\n\n```bash\npip install data-go-mcp.presidential-speeches\n```\n\n### Via UV\n\n```bash\nuvx data-go-mcp.presidential-speeches\n```\n\n## Configuration\n\n### Getting an API Key\n\n1. Visit [data.go.kr](https://www.data.go.kr)\n2. Sign up for an account\n3. Search for \"\ub300\ud1b5\ub839\uae30\ub85d\uad00 \uc5f0\uc124\ubb38\" API\n4. Apply for API access\n5. Get your service key from the API management page\n\n### Environment Setup\n\nSet your API key as an environment variable:\n\n```bash\nexport API_KEY=\"your-api-key-here\"\n```\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"data-go-mcp.presidential-speeches\": {\n \"command\": \"uvx\",\n \"args\": [\"data-go-mcp.presidential-speeches@latest\"],\n \"env\": {\n \"API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n## Available Tools\n\n### list_speeches\n\nList presidential speeches from the archives.\n\n**Parameters:**\n- `page` (int, optional): Page number (default: 1)\n- `per_page` (int, optional): Results per page (default: 10)\n- `use_2023_version` (bool, optional): Use 2023 version API (default: True)\n\n**Example Usage:**\n- \"List the latest presidential speeches\"\n- \"Show me 20 presidential speeches from page 2\"\n\n### search_speeches\n\nSearch presidential speeches with various filters.\n\n**Parameters:**\n- `president` (str, optional): Filter by president name\n- `title` (str, optional): Search by speech title keyword\n- `year` (int, optional): Filter by speech year\n- `location` (str, optional): Filter by speech location\n- `page` (int, optional): Page number (default: 1)\n- `per_page` (int, optional): Results per page (default: 10)\n\n**Example Usage:**\n- \"Search for speeches by \ub178\ubb34\ud604\"\n- \"Find speeches about \ud1b5\uc77c (unification)\"\n- \"Show speeches from 2020\"\n- \"Find speeches delivered at \uccad\uc640\ub300\"\n\n### get_recent_speeches\n\nGet recent presidential speeches.\n\n**Parameters:**\n- `president` (str, optional): Filter by president name\n- `limit` (int, optional): Number of speeches to retrieve (default: 5)\n\n**Example Usage:**\n- \"Show me the 10 most recent presidential speeches\"\n- \"Get the latest speeches by \uc724\uc11d\uc5f4\"\n\n## Response Format\n\nEach speech record contains:\n- `id`: Speech identifier (\uad6c\ubd84\ubc88\ud638)\n- `president`: President name (\ub300\ud1b5\ub839)\n- `title`: Speech title (\uae00\uc81c\ubaa9)\n- `year` or `date`: Speech year or date (\uc5f0\uc124\uc5f0\ub3c4/\uc5f0\uc124\uc77c\uc790)\n- `source_url`: Link to full text (\uc6d0\ubb38\ubcf4\uae30)\n- `location`: Speech location (\uc5f0\uc124\uc7a5\uc18c)\n\n## Development\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-org/data-go-mcp-servers.git\ncd data-go-mcp-servers/src/presidential-speeches\n\n# Install dependencies\nuv sync\n```\n\n### Testing\n\n```bash\n# Run tests\nuv run pytest tests/\n\n# Run with coverage\nuv run pytest tests/ --cov=data_go_mcp.presidential_speeches\n```\n\n### Running Locally\n\n```bash\n# Set your API key\nexport API_KEY=\"your-api-key\"\n\n# Run the server\nuv run python -m data_go_mcp.presidential_speeches.server\n```\n\n## API Documentation\n\nFor detailed API documentation, visit: https://api.odcloud.kr/api/15084167/v1\n\n## License\n\nApache License 2.0\n\n## Contributing\n\nContributions are welcome! Please see the [main repository](https://github.com/your-org/data-go-mcp-servers) for contribution guidelines.",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "MCP server for Access Korean presidential speech records from the Presidential Archives",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/your-org/data-go-mcp-servers/issues",
"Changelog": "https://github.com/your-org/data-go-mcp-servers/blob/main/src/presidential-speeches/CHANGELOG.md",
"Documentation": "https://github.com/your-org/data-go-mcp-servers/tree/main/src/presidential-speeches",
"Homepage": "https://github.com/your-org/data-go-mcp-servers",
"Repository": "https://github.com/your-org/data-go-mcp-servers"
},
"split_keywords": [
"api",
" data.go.kr",
" korea",
" mcp",
" presidential-speeches"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "dfd0dc3c06f8dd86cb3a6d7bd1b748da0e09db076a0d60dd233fb6302238099d",
"md5": "1ac1d5fae07d5c1993804716241fec05",
"sha256": "2ff898eee4abeffea6262b1fbabe062499c817df7636491ff936448baff1f60b"
},
"downloads": -1,
"filename": "data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1ac1d5fae07d5c1993804716241fec05",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9084,
"upload_time": "2025-08-28T14:41:37",
"upload_time_iso_8601": "2025-08-28T14:41:37.936632Z",
"url": "https://files.pythonhosted.org/packages/df/d0/dc3c06f8dd86cb3a6d7bd1b748da0e09db076a0d60dd233fb6302238099d/data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3b009b4434f5d96e88f4ee3abe58092403084ab55130cad8a2f30eb0c818b8e7",
"md5": "65dc4193f0fe8160c5dff6437ef2f9a2",
"sha256": "6d2207218651a09bb6e2bb091a21ded9a89b36e94a0b3dfe241f4736044df148"
},
"downloads": -1,
"filename": "data_go_mcp_presidential_speeches-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "65dc4193f0fe8160c5dff6437ef2f9a2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 9532,
"upload_time": "2025-08-28T14:41:39",
"upload_time_iso_8601": "2025-08-28T14:41:39.755330Z",
"url": "https://files.pythonhosted.org/packages/3b/00/9b4434f5d96e88f4ee3abe58092403084ab55130cad8a2f30eb0c818b8e7/data_go_mcp_presidential_speeches-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-28 14:41:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "your-org",
"github_project": "data-go-mcp-servers",
"github_not_found": true,
"lcname": "data-go-mcp.presidential-speeches"
}
JSON
