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
pip install data-go-mcp.presidential-speeches
Via UV
uvx data-go-mcp.presidential-speeches
Configuration
Getting an API Key
- Visit data.go.kr
- Sign up for an account
- Search for "대통령기록관 연설문" API
- Apply for API access
- Get your service key from the API management page
Environment Setup
Set your API key as an environment variable:
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
{
"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 nametitle(str, optional): Search by speech title keywordyear(int, optional): Filter by speech yearlocation(str, optional): Filter by speech locationpage(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 namelimit(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 (글제목)yearordate: Speech year or date (연설연도/연설일자)source_url: Link to full text (원문보기)location: Speech location (연설장소)
Development
Setup
# 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
# Run tests
uv run pytest tests/
# Run with coverage
uv run pytest tests/ --cov=data_go_mcp.presidential_speeches
Running Locally
# 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 for contribution guidelines.
Metadata
Release files for data-go-mcp.presidential-speeches 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| data_go_mcp_presidential_speeches-0.1.0.tar.gz | 9.5 kB | Without provenance | Details for data_go_mcp_presidential_speeches-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl |
Total release size: 18.6 kB
Release files / data_go_mcp_presidential_speeches-0.1.0.tar.gz
| Download URL | data_go_mcp_presidential_speeches-0.1.0.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6d2207218651a09bb6e2bb091a21ded9a89b36e94a0b3dfe241f4736044df148
|
|
BLAKE2b-256 checksum How to use checksums |
3b009b4434f5d96e88f4ee3abe58092403084ab55130cad8a2f30eb0c818b8e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Release files / data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl
| Download URL | data_go_mcp_presidential_speeches-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2ff898eee4abeffea6262b1fbabe062499c817df7636491ff936448baff1f60b
|
|
BLAKE2b-256 checksum How to use checksums |
dfd0dc3c06f8dd86cb3a6d7bd1b748da0e09db076a0d60dd233fb6302238099d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.5
|
Security for data-go-mcp.presidential-speeches 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.