pse-mcp 0.1.0

package/GEMINI.md

@@ -0,0 +1,72 @@
+# GEMINI.md
+
+## Project Overview
+
+This project is a TypeScript-based MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. It enables AI models to programmatically perform Google searches and analyze webpage content.
+
+The server is built with TypeScript and utilizes the `@modelcontextprotocol/sdk` for MCP communication. It exposes three main tools: `google_search`, `extract_webpage_content`, and `extract_multiple_webpages`.
+
+The core logic is divided into two services:
+-   `GoogleSearchService`: Handles interactions with the Google Custom Search API, including caching, pagination, and result categorization.
+-   `ContentExtractor`: Fetches and extracts the main content from webpages using `axios`, `cheerio`, and `@mozilla/readability`. It supports various output formats and caching.
+
+## Building and Running
+
+### Prerequisites
+
+-   Node.js (v16 or higher)
+-   Google Cloud Platform account
+-   Custom Search Engine ID
+-   Google API Key
+
+### Installation
+
+1.  Install Node.js dependencies:
+    ```bash
+    npm install
+    ```
+
+### Environment Variables
+
+The following environment variables must be set:
+
+-   `GOOGLE_API_KEY`: Your Google API key.
+-   `GOOGLE_SEARCH_ENGINE_ID`: Your Custom Search Engine ID.
+
+### Building
+
+To build the TypeScript code, run:
+
+```bash
+npm run build
+```
+
+This will compile the TypeScript files from `src` into JavaScript files in the `dist` directory.
+
+### Running
+
+To start the MCP server, run:
+
+```bash
+npm run start
+```
+
+This will execute the compiled `dist/google-search.js` file.
+
+For development, you can use:
+
+```bash
+npm run dev
+```
+
+This will watch for changes in the `src` directory and automatically recompile the code.
+
+## Development Conventions
+
+-   **Language:** TypeScript
+-   **Module System:** ES Modules (`"type": "module"` in `package.json`)
+-   **Compiler Target:** ES2020
+-   **Code Style:** The code is well-structured and follows standard TypeScript conventions. It uses classes for services and the main server logic.
+-   **Error Handling:** The code includes error handling for API requests and other operations.
+-   **Caching:** Caching is implemented for both search results and webpage content to improve performance and reduce API calls.
+-   **Testing:** There are no explicit test files in the provided structure.

package/License.md

@@ -0,0 +1,3 @@
+License:
+
+Free for non commercial use. 

package/MCP Documents/README.md

@@ -0,0 +1 @@
+# Files to assist in MCP Development