@dalcontak/blogger-mcp-server 1.0.0 → 1.0.2

package/dist/bloggerService.d.ts

@@ -1,121 +1,28 @@
 import { blogger_v3 } from 'googleapis';
-import { BloggerBlog, BloggerPost, BloggerLabel } from './types';
-/**
- * Custom types to compensate for Blogger API limitations
- */
+import { BloggerPost } from './types';
 interface BloggerLabelList {
     kind?: string;
-    items?: BloggerLabel[];
+    items?: Array<{
+        name: string;
+    }>;
 }
-/**
- * Google Blogger API interaction service
- *
- * Supports two authentication modes:
- * - OAuth2 (GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + GOOGLE_REFRESH_TOKEN):
- *   full access (read + write). Required for listBlogs, createPost, updatePost, deletePost.
- * - API Key (BLOGGER_API_KEY): read-only access to public blogs.
- *   Works for getBlog, listPosts, getPost, searchPosts, listLabels, getLabel.
- *
- * If both are configured, OAuth2 is used (it covers all operations).
- */
 export declare class BloggerService {
     private blogger;
     private readonly isOAuth2;
-    /**
-     * Initializes the Blogger service with OAuth2 or API key
-     */
     constructor();
-    /**
-     * Checks that OAuth2 authentication is available.
-     * Throws an explicit error if the operation requires OAuth2 and we are in API key mode.
-     */
     private requireOAuth2;
-    /**
-     * Lists all blogs for the authenticated user.
-     * Requires OAuth2 (blogs.listByUser with userId: 'self').
-     * @returns Blog list
-     */
     listBlogs(): Promise<blogger_v3.Schema$BlogList>;
-    /**
-     * Retrieves details of a specific blog
-     * @param blogId ID of the blog to retrieve
-     * @returns Blog details
-     */
     getBlog(blogId: string): Promise<blogger_v3.Schema$Blog>;
-    /**
-     * Retrieves a blog by its URL
-     * @param url Blog URL
-     * @returns Blog details
-     */
     getBlogByUrl(url: string): Promise<blogger_v3.Schema$Blog>;
-    /**
-     * Simulates blog creation.
-     * Note: The Blogger API does not actually allow creating a blog via API.
-     * This method simulates the functionality and returns an explanatory error message.
-     *
-     * @param blogData Blog data to create
-     * @returns Explanatory error message
-     */
-    createBlog(blogData: Partial<BloggerBlog>): Promise<any>;
-    /**
-     * Lists posts from a blog
-     * @param blogId Blog ID
-     * @param maxResults Maximum number of results to return
-     * @returns Post list
-     */
     listPosts(blogId: string, maxResults?: number): Promise<blogger_v3.Schema$PostList>;
-    /**
-     * Searches posts in a blog using the native posts.search endpoint of the Blogger API
-     * @param blogId Blog ID
-     * @param query Search term
-     * @param maxResults Maximum number of results to return
-     * @returns List of matching posts
-     */
     searchPosts(blogId: string, query: string, maxResults?: number): Promise<blogger_v3.Schema$PostList>;
-    /**
-     * Retrieves a specific post
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @returns Post details
-     */
     getPost(blogId: string, postId: string): Promise<blogger_v3.Schema$Post>;
-    /**
-     * Creates a new post in a blog.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postData Post data to create
-     * @returns Created post
-     */
     createPost(blogId: string, postData: Partial<BloggerPost>): Promise<blogger_v3.Schema$Post>;
-    /**
-     * Updates an existing post.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @param postData Post data to update
-     * @returns Updated post
-     */
     updatePost(blogId: string, postId: string, postData: Partial<BloggerPost>): Promise<blogger_v3.Schema$Post>;
-    /**
-     * Deletes a post.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @returns Deletion status
-     */
     deletePost(blogId: string, postId: string): Promise<void>;
-    /**
-     * Lists labels from a blog
-     * @param blogId Blog ID
-     * @returns Label list
-     */
     listLabels(blogId: string): Promise<BloggerLabelList>;
-    /**
-     * Retrieves a specific label
-     * @param blogId Blog ID
-     * @param labelName Label name
-     * @returns Label details
-     */
-    getLabel(blogId: string, labelName: string): Promise<BloggerLabel>;
+    getLabel(blogId: string, labelName: string): Promise<{
+        name: string;
+    }>;
 }
 export {};

package/dist/bloggerService.js

@@ -3,21 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BloggerService = void 0;
 const googleapis_1 = require("googleapis");
 const config_1 = require("./config");
-/**
- * Google Blogger API interaction service
- *
- * Supports two authentication modes:
- * - OAuth2 (GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + GOOGLE_REFRESH_TOKEN):
- *   full access (read + write). Required for listBlogs, createPost, updatePost, deletePost.
- * - API Key (BLOGGER_API_KEY): read-only access to public blogs.
- *   Works for getBlog, listPosts, getPost, searchPosts, listLabels, getLabel.
- *
- * If both are configured, OAuth2 is used (it covers all operations).
- */
 class BloggerService {
-    /**
-     * Initializes the Blogger service with OAuth2 or API key
-     */
     constructor() {
         const { oauth2 } = config_1.config;
         const hasOAuth2 = !!(oauth2.clientId && oauth2.clientSecret && oauth2.refreshToken);
@@ -47,10 +33,6 @@ class BloggerService {
                 'GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + GOOGLE_REFRESH_TOKEN (full access).');
         }
     }
-    /**
-     * Checks that OAuth2 authentication is available.
-     * Throws an explicit error if the operation requires OAuth2 and we are in API key mode.
-     */
     requireOAuth2(operation) {
         if (!this.isOAuth2) {
             throw new Error(`Operation "${operation}" requires OAuth2 authentication. ` +
@@ -58,11 +40,6 @@ class BloggerService {
                 'Configure GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET and GOOGLE_REFRESH_TOKEN.');
         }
     }
-    /**
-     * Lists all blogs for the authenticated user.
-     * Requires OAuth2 (blogs.listByUser with userId: 'self').
-     * @returns Blog list
-     */
     async listBlogs() {
         this.requireOAuth2('list_blogs');
         try {
@@ -76,16 +53,9 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Retrieves details of a specific blog
-     * @param blogId ID of the blog to retrieve
-     * @returns Blog details
-     */
     async getBlog(blogId) {
         try {
-            const response = await this.blogger.blogs.get({
-                blogId
-            });
+            const response = await this.blogger.blogs.get({ blogId });
             return response.data;
         }
         catch (error) {
@@ -93,16 +63,9 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Retrieves a blog by its URL
-     * @param url Blog URL
-     * @returns Blog details
-     */
     async getBlogByUrl(url) {
         try {
-            const response = await this.blogger.blogs.getByUrl({
-                url
-            });
+            const response = await this.blogger.blogs.getByUrl({ url });
             return response.data;
         }
         catch (error) {
@@ -110,31 +73,6 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Simulates blog creation.
-     * Note: The Blogger API does not actually allow creating a blog via API.
-     * This method simulates the functionality and returns an explanatory error message.
-     *
-     * @param blogData Blog data to create
-     * @returns Explanatory error message
-     */
-    async createBlog(blogData) {
-        // Simulate a delay to make the response more realistic
-        await new Promise(resolve => setTimeout(resolve, 500));
-        // Return an explanatory error message
-        return {
-            error: true,
-            message: "The Google Blogger API does not allow creating a new blog via API. Please create a blog manually on blogger.com.",
-            details: "This limitation is documented by Google. Blogs must be created via the Blogger web interface.",
-            suggestedAction: "Create a blog at https://www.blogger.com, then use its ID with this MCP server."
-        };
-    }
-    /**
-     * Lists posts from a blog
-     * @param blogId Blog ID
-     * @param maxResults Maximum number of results to return
-     * @returns Post list
-     */
     async listPosts(blogId, maxResults) {
         try {
             const response = await this.blogger.posts.list({
@@ -148,13 +86,6 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Searches posts in a blog using the native posts.search endpoint of the Blogger API
-     * @param blogId Blog ID
-     * @param query Search term
-     * @param maxResults Maximum number of results to return
-     * @returns List of matching posts
-     */
     async searchPosts(blogId, query, maxResults) {
         try {
             const response = await this.blogger.posts.search({
@@ -162,8 +93,6 @@ class BloggerService {
                 q: query,
                 fetchBodies: true
             });
-            // The search endpoint does not support maxResults directly,
-            // so we truncate client-side if needed
             const items = response.data.items || [];
             const limit = maxResults || config_1.config.blogger.maxResults;
             return {
@@ -176,18 +105,9 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Retrieves a specific post
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @returns Post details
-     */
     async getPost(blogId, postId) {
         try {
-            const response = await this.blogger.posts.get({
-                blogId,
-                postId
-            });
+            const response = await this.blogger.posts.get({ blogId, postId });
             return response.data;
         }
         catch (error) {
@@ -195,20 +115,15 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Creates a new post in a blog.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postData Post data to create
-     * @returns Created post
-     */
     async createPost(blogId, postData) {
         this.requireOAuth2('create_post');
         try {
-            const response = await this.blogger.posts.insert({
-                blogId,
-                requestBody: postData
-            });
+            const requestBody = {
+                title: postData.title ?? undefined,
+                content: postData.content ?? undefined,
+                labels: postData.labels ?? undefined
+            };
+            const response = await this.blogger.posts.insert({ blogId, requestBody });
             return response.data;
         }
         catch (error) {
@@ -216,28 +131,15 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Updates an existing post.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @param postData Post data to update
-     * @returns Updated post
-     */
     async updatePost(blogId, postId, postData) {
         this.requireOAuth2('update_post');
         try {
-            // Convert types to avoid compilation errors
             const requestBody = {
-                title: postData.title,
-                content: postData.content,
-                labels: postData.labels
+                title: postData.title ?? undefined,
+                content: postData.content ?? undefined,
+                labels: postData.labels ?? undefined
             };
-            const response = await this.blogger.posts.update({
-                blogId,
-                postId,
-                requestBody
-            });
+            const response = await this.blogger.posts.update({ blogId, postId, requestBody });
             return response.data;
         }
         catch (error) {
@@ -245,68 +147,37 @@ class BloggerService {
             throw error;
         }
     }
-    /**
-     * Deletes a post.
-     * Requires OAuth2.
-     * @param blogId Blog ID
-     * @param postId Post ID
-     * @returns Deletion status
-     */
     async deletePost(blogId, postId) {
         this.requireOAuth2('delete_post');
         try {
-            await this.blogger.posts.delete({
-                blogId,
-                postId
-            });
+            await this.blogger.posts.delete({ blogId, postId });
         }
         catch (error) {
             console.error(`Error deleting post ${postId}:`, error);
             throw error;
         }
     }
-    /**
-     * Lists labels from a blog
-     * @param blogId Blog ID
-     * @returns Label list
-     */
     async listLabels(blogId) {
         try {
-            // The Blogger API does not provide a direct endpoint to list labels
-            // We fetch all posts and extract unique labels
             const response = await this.blogger.posts.list({
                 blogId,
-                maxResults: 50 // Fetch enough posts to extract labels
+                maxResults: 50
             });
             const posts = response.data.items || [];
             const labelSet = new Set();
-            // Extract all unique labels from posts
             posts.forEach(post => {
-                const postLabels = post.labels || [];
-                postLabels.forEach(label => labelSet.add(label));
+                (post.labels || []).forEach(label => labelSet.add(label));
             });
-            // Convert to expected format
             const labels = Array.from(labelSet).map(name => ({ name }));
-            return {
-                kind: 'blogger#labelList',
-                items: labels
-            };
+            return { kind: 'blogger#labelList', items: labels };
         }
         catch (error) {
             console.error(`Error fetching labels for blog ${blogId}:`, error);
             throw error;
         }
     }
-    /**
-     * Retrieves a specific label
-     * @param blogId Blog ID
-     * @param labelName Label name
-     * @returns Label details
-     */
     async getLabel(blogId, labelName) {
         try {
-            // The Blogger API does not provide a direct endpoint to retrieve a label
-            // We check if the label exists by listing all labels
             const labels = await this.listLabels(blogId);
             const label = labels.items?.find(l => l.name === labelName);
             if (!label) {

package/dist/config.d.ts

@@ -17,4 +17,7 @@ export declare const config: {
     logging: {
         level: string;
     };
+    ui: {
+        port: number;
+    };
 };

package/dist/config.js

@@ -1,32 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.config = void 0;
-// MCP server configuration for Blogger
+function safeInt(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
 exports.config = {
-    // Server operating mode (stdio or http)
     mode: process.env.MCP_MODE || 'stdio',
-    // HTTP mode configuration (if used)
     http: {
         host: process.env.MCP_HTTP_HOST || '0.0.0.0',
-        port: parseInt(process.env.MCP_HTTP_PORT || '3000', 10)
+        port: safeInt(process.env.MCP_HTTP_PORT, 3000)
     },
-    // Blogger API configuration
     blogger: {
         apiKey: process.env.BLOGGER_API_KEY,
-        // Default maximum number of results for list queries
-        maxResults: parseInt(process.env.BLOGGER_MAX_RESULTS || '10', 10),
-        // API request timeout in milliseconds
-        timeout: parseInt(process.env.BLOGGER_API_TIMEOUT || '30000', 10)
+        maxResults: safeInt(process.env.BLOGGER_MAX_RESULTS, 10),
+        timeout: safeInt(process.env.BLOGGER_API_TIMEOUT, 30000)
     },
-    // OAuth2 configuration for authenticated operations (create, update, delete)
-    // If these variables are not set, the server runs in read-only mode (API key)
     oauth2: {
         clientId: process.env.GOOGLE_CLIENT_ID,
         clientSecret: process.env.GOOGLE_CLIENT_SECRET,
         refreshToken: process.env.GOOGLE_REFRESH_TOKEN
     },
-    // Logging configuration
     logging: {
         level: process.env.LOG_LEVEL || 'info'
+    },
+    ui: {
+        port: safeInt(process.env.UI_PORT, 0)
     }
 };