wip: readme upload

Author: viczommers

.gitignore

@@ -0,0 +1,50 @@
+# Dependencies
+node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+dist/
+bin/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# IDE and editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Test coverage
+coverage/
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# Debug files
+.debug/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.pytest_cache/
+.python-version
+.venv/

LICENSE

@@ -0,0 +1,23 @@
+# API License Agreement
+This API License Agreement ("Agreement") is entered into by and between you ("Licensee") and Lambda Capture Limited ("Licensor") registration number 15845351, 52 Tabernacle Street, London, EC2A 4NJ.
+
+## 1. License Grant
+Licensor grants Licensee a non-exclusive, non-transferable, limited license to use the API and its associated data ("API Data") solely for research purposes or other internal business operations. You are not permitted to copy, modify, distribute, or use the API or API Data for any external commercial purpose or resell it to any third party.
+
+## 2. Restrictions
+- The code and functionality of the API, including any related components and services, remain the exclusive property of Lambda Capture Limited.  
+- Licensee shall not use the API or API Data for any purpose other than research or internal business operations.  
+- Licensee is prohibited from using the API or API Data from reselling or redistributing the API Data to third parties in any manner.  
+- Licensee shall not reverse engineer, decompile, or otherwise attempt to extract the underlying code of the API.
+
+## 3. Ownership
+All intellectual property rights, including but not limited to copyrights, trademarks, and patents, related to the API and API Data are owned by Lambda Capture Limited. This Agreement does not grant any ownership rights to Licensee.
+
+## 4. Term and Termination
+This Agreement is effective upon Licensee's acceptance and continues until terminated. By using the API, Licensee agrees to be bound by the terms of this Agreement. Licensor may terminate this Agreement at any time if Licensee breaches any of its terms. Upon termination, Licensee must immediately cease all use of the API and destroy any copies of the API Data.
+
+## 5. Limitation of Liability
+Licensor is not responsible for any damages resulting from Licensee's use or inability to use the API. Licensee uses the API at their own risk.
+
+## 6. Governing Law
+This Agreement shall be governed by and construed in accordance with the laws of the United Kingdom.

README.md

@@ -1 +1,55 @@
-# mcp-server
+# Lambda Capture MCP Server
+MCP implementation of our standard [Semantic Search API](https://github.com/lambda-capture/Semantic-Search-API)
+## Pre-requisites
+- [Lambda Capture API key](https://lambda-capture.com/)
+- for MCP Typescript: [Node.js 18+ (includes npx and npm)](https://nodejs.org/en/download/)
+- for MCP Python: [Python 3.11+](https://www.python.org/downloads/)
+
+
+## Installation
+1. Clone the repo  
+### Node:
+2. `npm install` to install the dependencies
+3. `npm run build` to build the project  
+### Python:
+2. `python -m venv .venv` create virtual environment
+3. `source .venv/bin/activate` activate virtual environment
+4. `pip install -r requirements.txt` install the dependencies
+
+## Configure your MCP Client (Claude Desktop)
+Go to Claude -> Settings -> Developer -> Edit Config. Add the following to your `claude_desktop_config.json`  
+### Node: 
+```json
+{
+  "mcpServers": {
+    "lambda-capture": {
+      "command": "node",
+      "args": [
+        "/Absolute Path to/mcp-server/dist/index.js"
+      ],
+      "env": {
+        "LAMBDA_CAPTURE_API_KEY": "Your API Key string"
+      },
+      "description": "Runs the Python MCP with Lambda Capture Macroeconomic Data API"
+    }
+  }
+}
+```  
+### Python: 
+```json
+{
+  "mcpServers": {
+    "lambda-capture-mcp": {
+      "command": "/Absolute Path to/.venv/bin/python",
+      "args": [
+        "/Absolute Path to/mcp-server/main.py"
+      ],
+      "env": {
+        "LAMBDA_CAPTURE_API_KEY": "Your API Key string"
+      },
+      "description": "Runs the Python MCP with Lambda Capture Macroeconomic Data API"
+    }
+  }
+}
+```
+© 2025 Lambda Capture Limited (Registration Number 15845351) 52 Tabernacle Street, London, EC2A 4NJ - All rights reserved