nia-mcp-server 1.0.59__tar.gz

nia_mcp_server-1.0.59/.gitignore

@@ -0,0 +1,54 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment variables
+.env
+.env.local
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Distribution
+*.whl
+*.tar.gz

nia_mcp_server-1.0.59/ARCHITECTURE.md

@@ -0,0 +1,101 @@
+# NIA MCP Server Architecture
+
+## Overview
+
+The NIA MCP Server is a lightweight proxy that enables any MCP-compatible AI assistant to interact with NIA's production API. Users only need their NIA API key to get started.
+
+## Design Principles
+
+1. **Zero Infrastructure**: Users don't need MongoDB, vector stores, or any backend setup
+2. **API Key Only**: Single configuration requirement - just the NIA API key
+3. **Stateless**: All state is managed by NIA's backend
+4. **Lightweight**: Minimal dependencies (mcp, httpx, pydantic)
+5. **Universal**: Works with any MCP client (Claude Desktop, Continue, etc.)
+
+## Architecture
+
+```
+┌─────────────────┐     ┌──────────────────┐     ┌────────────────┐
+│   MCP Client    │────▶│  NIA MCP Server  │────▶│   NIA API      │
+│ (Claude, etc.)  │◀────│   (Local Proxy)  │◀────│  (Production)  │
+└─────────────────┘     └──────────────────┘     └────────────────┘
+        MCP                    HTTPS                   Backend
+     Protocol                Requests               Infrastructure
+```
+
+## Components
+
+### 1. MCP Server (`server.py`)
+- Implements MCP protocol
+- Exposes tools and resources
+- Handles async operations
+- Manages API client lifecycle
+
+### 2. API Client (`api_client.py`)
+- HTTP client for NIA's V2 API
+- Handles authentication
+- Streaming response support
+- Error handling and retries
+
+### 3. Tools
+- `index_repository` - Start indexing a GitHub repo
+- `search` - Unified natural-language search across repositories and docs
+- `list_repositories` - List indexed repos
+- `check_repository_status` - Check indexing progress
+- `delete_repository` - Remove indexed repo
+
+### 4. Resources
+- Exposes indexed repositories as MCP resources
+- Provides metadata about each repository
+- Enables AI assistants to understand available codebases
+
+## API Endpoints Used
+
+The proxy communicates with NIA's V2 API:
+
+- `GET /v2/repositories` - List repositories
+- `POST /v2/repositories` - Index new repository
+- `GET /v2/repositories/{owner/repo}` - Get repository status
+- `DELETE /v2/repositories/{owner/repo}` - Delete repository
+- `POST /v2/query` - Unified repository/documentation search (streaming)
+
+## Authentication
+
+All requests include the API key in the Authorization header:
+```
+Authorization: Bearer YOUR-API-KEY
+```
+
+## Error Handling
+
+1. **Invalid API Key**: Clear error message with link to get key
+2. **Rate Limiting**: Passes through API rate limit errors
+3. **Network Errors**: Retries with exponential backoff
+4. **Indexing Failures**: Reports detailed error messages
+
+## Distribution
+
+### PyPI Package
+```bash
+pip install nia-mcp-server
+```
+
+### NPM Wrapper (Optional)
+```bash
+npx @trynia/mcp-server
+```
+
+## Security
+
+- API keys are never logged or stored
+- All communication uses HTTPS
+- No data is stored locally
+- User isolation handled by NIA backend
+
+## Future Enhancements
+
+1. **Caching**: Local caching of repository lists
+2. **Offline Mode**: Queue operations when offline
+3. **Advanced Search**: More search options
+4. **Web/Text Sources**: Support for non-code content
+5. **Batch Operations**: Index multiple repos at once

nia_mcp_server-1.0.59/LICENSE

@@ -0,0 +1,31 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2025 NIA (trynia.ai)
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Additional permissions under GNU AGPL version 3 section 7:
+
+If you modify this Program, or any covered work, by linking or combining it 
+with other code, such other code is not for that reason alone subject to any 
+of the requirements of the GNU Affero General Public License.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
+YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

nia_mcp_server-1.0.59/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: nia-mcp-server
+Version: 1.0.59
+Summary: Nia
+Project-URL: Homepage, https://trynia.ai
+Project-URL: Documentation, https://docs.trynia.ai
+Author-email: Nozomio Labs Team <founders@nozomio.com>
+License-Expression: AGPL-3.0
+License-File: LICENSE
+Keywords: ai,codebase,mcp,nia,search
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Requires-Dist: fastmcp==2.13.2
+Requires-Dist: httpcore>=1.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: python-levenshtein>=0.21.0
+Requires-Dist: uvicorn>=0.30.0
+Description-Content-Type: text/markdown
+
+# NIA MCP Server
+
+The NIA MCP Server enables AI assistants like Claude to search and understand your indexed codebases through the Model Context Protocol (MCP).
+
+## Quick Start
+
+### Automatic Setup (Recommended) ✨
+
+Get your API key from [https://trynia.ai/api-keys](https://trynia.ai/api-keys) and run:
+
+```bash
+yay
+pipx run nia-mcp-server setup YOUR_API_KEY
+```

nia_mcp_server-1.0.59/README.md

@@ -0,0 +1,14 @@
+# NIA MCP Server
+
+The NIA MCP Server enables AI assistants like Claude to search and understand your indexed codebases through the Model Context Protocol (MCP).
+
+## Quick Start
+
+### Automatic Setup (Recommended) ✨
+
+Get your API key from [https://trynia.ai/api-keys](https://trynia.ai/api-keys) and run:
+
+```bash
+yay
+pipx run nia-mcp-server setup YOUR_API_KEY
+```