guardian-mcp-server
Version:
MCP server for The Guardian newspaper
132 lines • 5.17 kB
JavaScript
export function formatArticleResponse(articles, pagination, options) {
if (!articles || articles.length === 0) {
return 'No articles found matching your criteria.';
}
let result = `Found ${articles.length} article(s):\n\n`;
articles.forEach((article, index) => {
result += `**${index + 1}. ${article.webTitle || 'Untitled'}**\n`;
if (article.fields) {
const { fields } = article;
if (fields.byline) {
result += `By: ${fields.byline}\n`;
}
if (fields.firstPublicationDate) {
const pubDate = fields.firstPublicationDate.substring(0, 10); // Extract date part
result += `Published: ${pubDate}\n`;
}
if (fields.standfirst) {
result += `Summary: ${fields.standfirst}\n`;
}
}
result += `Section: ${article.sectionName || 'Unknown'}\n`;
result += `URL: ${article.webUrl || 'N/A'}\n`;
result += `Guardian ID: ${article.id || 'N/A'}\n`;
// Add tags if available and requested
if (options?.showTags && article.tags && article.tags.length > 0) {
const tags = article.tags.slice(0, 10).map(tag => tag.webTitle).join(', ');
result += `Tags: ${tags}${article.tags.length > 10 ? ' (+' + (article.tags.length - 10) + ' more)' : ''}\n`;
}
if (article.fields?.body) {
// Remove HTML tags
let body = article.fields.body.replace(/<[^>]+>/g, '');
// Apply truncation only if requested (default: no truncation for v2.0)
const shouldTruncate = options?.truncate ?? false;
const maxLength = options?.maxLength ?? 500;
if (shouldTruncate && body.length > maxLength) {
body = body.substring(0, maxLength) + '...';
result += `Content preview: ${body}\n`;
}
else {
result += `Content: ${body}\n`;
}
}
result += '\n';
});
if (pagination && pagination.pages > 1) {
result += `\nPagination: Page ${pagination.currentPage} of ${pagination.pages}\n`;
if (pagination.currentPage < pagination.pages) {
result += "Use the 'page' parameter to get more results.\n";
}
}
return result;
}
export function formatTagsResponse(tags, query, pagination) {
if (!tags || tags.length === 0) {
return `No tags found matching '${query}'.`;
}
let result = `Found ${tags.length} tag(s) matching '${query}':\n\n`;
tags.forEach((tag, index) => {
result += `**${index + 1}. ${tag.webTitle || 'Unknown'}**\n`;
result += `ID: ${tag.id || 'N/A'}\n`;
result += `Type: ${tag.type || 'N/A'}\n`;
result += `URL: ${tag.webUrl || 'N/A'}\n\n`;
});
if (pagination && pagination.pages > 1) {
result += `\nPagination: Page ${pagination.currentPage} of ${pagination.pages}\n`;
}
return result;
}
export function formatSectionsResponse(sections) {
if (!sections || sections.length === 0) {
return 'No sections found.';
}
let result = 'Available Guardian sections:\n\n';
sections.forEach((section) => {
result += `**${section.webTitle || 'Unknown'}**\n`;
result += `ID: ${section.id || 'N/A'}\n`;
result += `URL: ${section.webUrl || 'N/A'}\n\n`;
});
return result;
}
export function validateDate(dateStr) {
if (!dateStr) {
return null;
}
try {
// Try parsing common date formats
const formats = [
/^\d{4}-\d{2}-\d{2}$/, // YYYY-MM-DD
/^\d{4}\/\d{2}\/\d{2}$/, // YYYY/MM/DD
/^\d{2}\/\d{2}\/\d{4}$/, // MM/DD/YYYY
/^\d{2}\/\d{2}\/\d{4}$/, // DD/MM/YYYY
];
for (const format of formats) {
if (format.test(dateStr)) {
const date = new Date(dateStr);
if (!isNaN(date.getTime())) {
return date.toISOString().substring(0, 10);
}
}
}
return null;
}
catch {
return null;
}
}
export function calculateDateFromDaysBack(daysBack) {
const targetDate = new Date();
targetDate.setDate(targetDate.getDate() - daysBack);
return targetDate.toISOString().substring(0, 10);
}
export function parseGuardianUrl(articleIdOrUrl) {
// If it's already an article ID (no protocol), return as-is
if (!articleIdOrUrl.startsWith('http')) {
return articleIdOrUrl;
}
// Parse Guardian URL to extract article ID
try {
const url = new URL(articleIdOrUrl);
if (url.hostname === 'www.theguardian.com' || url.hostname === 'theguardian.com') {
// Remove leading slash and return the path as article ID
return url.pathname.substring(1);
}
}
catch (error) {
// If URL parsing fails, try string replacement as fallback
return articleIdOrUrl.replace(/https?:\/\/(www\.)?theguardian\.com\//, '');
}
// If not a Guardian URL, return as-is
return articleIdOrUrl;
}
//# sourceMappingURL=formatters.js.map