nia-mcp-server


Namenia-mcp-server JSON
Version 1.0.9 PyPI version JSON
download
home_pageNone
SummaryNia Knowledge Agent
upload_time2025-07-21 05:33:59
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords ai codebase mcp nia search
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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

### 1. Get your NIA API Key

Sign up and get your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)

### 2. Install via pip

```bash
pip install nia-mcp-server
```

### 3. Configure with Claude Desktop

Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "nia": {
      "command": "nia-mcp-server",
      "env": {
        "NIA_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### 4. Restart Claude Desktop

That's it! You can now ask Claude to index and search codebases.

## Usage Examples

### Index a repository
```
Claude, please index https://github.com/facebook/react
```

### Index documentation
```
Index the documentation at https://docs.python.org
```

### Search across everything
```
How does async/await work? Search both my code and documentation.
```

### Search only repositories
```
Find the authentication logic in my repositories
```

### Search only documentation
```
What are the best practices for error handling according to the docs?
```

### Search and index new content
```
Find the best RAG implementations out there
```
Claude will:
1. Use the `nia_web_search` tool to find trending RAG repos
2. Show you the results with summaries
3. Prompt you to index the ones you want
4. You say "Index the first two" and it indexes them!

```
What are the hottest new Rust web frameworks this week?
```
Claude searches trending repos and guides you through indexing them.

Advanced search examples:
```
Find GitHub repos similar to langchain/langchain

Search for AI papers published in the last 30 days

What are the trending machine learning frameworks this month?
```

### Deep research questions
```
Compare the top 3 vector databases for RAG applications

What are the pros and cons of different LLM orchestration frameworks?

Research the latest developments in AI agent architectures
```

### List your resources
```
Show me all my indexed repositories and documentation
```

## Available Tools

### Search & Research
- **`nia_web_search`** - AI-powered search of repositories, documentation, and content
  - Finds trending GitHub repos, relevant documentation, and more
  - Returns structured results that guide you to index the best content
  - Advanced options:
    - `category`: Filter by type (github, company, research paper, news, etc.)
    - `days_back`: Find content from the last N days (great for trending)
    - `find_similar_to`: Search for content similar to a given URL
  - Built into NIA's advanced search capabilities

- **`nia_deep_research_agent`** - Multi-step AI research for complex questions
  - Best for comparative analysis, comprehensive overviews
  - Returns structured data with citations
  - Examples: "Compare top RAG frameworks", "Analyze trends in AI safety"

### Repository Management
- **`index_repository`** - Index a GitHub repository
- **`list_repositories`** - List all indexed repositories
- **`check_repository_status`** - Check repository indexing progress
- **`delete_repository`** - Remove an indexed repository

### Documentation Management
- **`index_documentation`** - Index documentation or any website
- **`list_documentation`** - List all indexed documentation sources
- **`check_documentation_status`** - Check documentation indexing progress
- **`delete_documentation`** - Remove indexed documentation

### Unified Search
- **`search_codebase`** - Search across repositories and/or documentation
  - `search_mode`: "repositories", "sources", or "unified" (default)
  - Automatically searches all indexed content if not specified

## Other MCP Clients

### Continue.dev

Add to your `~/.continue/config.json`:

```json
{
  "models": [...],
  "mcpServers": [
    {
      "name": "nia",
      "command": "nia-mcp-server",
      "env": {
        "NIA_API_KEY": "your-api-key-here"
      }
    }
  ]
}
```

### VS Code Cline

Add to your Cline settings:

```json
{
  "mcpServers": {
    "nia": {
      "command": "nia-mcp-server",
      "env": {
        "NIA_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

## Environment Variables

- `NIA_API_KEY` (required) - Your NIA API key
- `NIA_API_URL` (optional) - API endpoint (defaults to https://apigcp.trynia.ai)

## Pricing

NIA offers simple, transparent pricing:

- **Free Tier**: Limited usage, public repos only
- **Pro**: Unlimited API calls, private repos, advanced features

See [https://trynia.ai/pricing](https://trynia.ai/pricing) for details.

## Features

- 🔍 **Unified Search** - Search across code AND documentation seamlessly
- 📚 **Documentation Indexing** - Index any website or documentation
- 🚀 **Fast Indexing** - Index repositories and websites quickly
- 🔒 **Private Repos** - Support for private repositories (Pro)
- 📊 **Smart Understanding** - AI-powered code and content comprehension
- 🌐 **Works Everywhere** - Any MCP-compatible client

## Troubleshooting

### "No API key provided"
Make sure `NIA_API_KEY` is set in your MCP client configuration.

### "Invalid API key"
Check your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)

### "Rate limit exceeded"
You've hit your monthly limit. Upgrade at [https://trynia.ai/billing](https://trynia.ai/billing)

### Repository not indexing
Large repositories can take a few minutes. Use `check_repository_status` to monitor progress.

## Support

- Documentation: [https://docs.trynia.ai](https://docs.trynia.ai)
- Discord: [https://discord.gg/BBSwUMrrfn](https://discord.gg/BBSwUMrrfn)
- Email: support@trynia.ai

## License

MIT License - see LICENSE file for details.
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "nia-mcp-server",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "ai, codebase, mcp, nia, search",
    "author": null,
    "author_email": "Nia Team <founders@nozomio.com>",
    "download_url": "https://files.pythonhosted.org/packages/15/00/e30f9f509d7cb5775b480d4c417369327e2fe87de6329e816ecf468bb910/nia_mcp_server-1.0.9.tar.gz",
    "platform": null,
    "description": "# NIA MCP Server\n\nThe NIA MCP Server enables AI assistants like Claude to search and understand your indexed codebases through the Model Context Protocol (MCP).\n\n## Quick Start\n\n### 1. Get your NIA API Key\n\nSign up and get your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)\n\n### 2. Install via pip\n\n```bash\npip install nia-mcp-server\n```\n\n### 3. Configure with Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"nia\": {\n      \"command\": \"nia-mcp-server\",\n      \"env\": {\n        \"NIA_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### 4. Restart Claude Desktop\n\nThat's it! You can now ask Claude to index and search codebases.\n\n## Usage Examples\n\n### Index a repository\n```\nClaude, please index https://github.com/facebook/react\n```\n\n### Index documentation\n```\nIndex the documentation at https://docs.python.org\n```\n\n### Search across everything\n```\nHow does async/await work? Search both my code and documentation.\n```\n\n### Search only repositories\n```\nFind the authentication logic in my repositories\n```\n\n### Search only documentation\n```\nWhat are the best practices for error handling according to the docs?\n```\n\n### Search and index new content\n```\nFind the best RAG implementations out there\n```\nClaude will:\n1. Use the `nia_web_search` tool to find trending RAG repos\n2. Show you the results with summaries\n3. Prompt you to index the ones you want\n4. You say \"Index the first two\" and it indexes them!\n\n```\nWhat are the hottest new Rust web frameworks this week?\n```\nClaude searches trending repos and guides you through indexing them.\n\nAdvanced search examples:\n```\nFind GitHub repos similar to langchain/langchain\n\nSearch for AI papers published in the last 30 days\n\nWhat are the trending machine learning frameworks this month?\n```\n\n### Deep research questions\n```\nCompare the top 3 vector databases for RAG applications\n\nWhat are the pros and cons of different LLM orchestration frameworks?\n\nResearch the latest developments in AI agent architectures\n```\n\n### List your resources\n```\nShow me all my indexed repositories and documentation\n```\n\n## Available Tools\n\n### Search & Research\n- **`nia_web_search`** - AI-powered search of repositories, documentation, and content\n  - Finds trending GitHub repos, relevant documentation, and more\n  - Returns structured results that guide you to index the best content\n  - Advanced options:\n    - `category`: Filter by type (github, company, research paper, news, etc.)\n    - `days_back`: Find content from the last N days (great for trending)\n    - `find_similar_to`: Search for content similar to a given URL\n  - Built into NIA's advanced search capabilities\n\n- **`nia_deep_research_agent`** - Multi-step AI research for complex questions\n  - Best for comparative analysis, comprehensive overviews\n  - Returns structured data with citations\n  - Examples: \"Compare top RAG frameworks\", \"Analyze trends in AI safety\"\n\n### Repository Management\n- **`index_repository`** - Index a GitHub repository\n- **`list_repositories`** - List all indexed repositories\n- **`check_repository_status`** - Check repository indexing progress\n- **`delete_repository`** - Remove an indexed repository\n\n### Documentation Management\n- **`index_documentation`** - Index documentation or any website\n- **`list_documentation`** - List all indexed documentation sources\n- **`check_documentation_status`** - Check documentation indexing progress\n- **`delete_documentation`** - Remove indexed documentation\n\n### Unified Search\n- **`search_codebase`** - Search across repositories and/or documentation\n  - `search_mode`: \"repositories\", \"sources\", or \"unified\" (default)\n  - Automatically searches all indexed content if not specified\n\n## Other MCP Clients\n\n### Continue.dev\n\nAdd to your `~/.continue/config.json`:\n\n```json\n{\n  \"models\": [...],\n  \"mcpServers\": [\n    {\n      \"name\": \"nia\",\n      \"command\": \"nia-mcp-server\",\n      \"env\": {\n        \"NIA_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  ]\n}\n```\n\n### VS Code Cline\n\nAdd to your Cline settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"nia\": {\n      \"command\": \"nia-mcp-server\",\n      \"env\": {\n        \"NIA_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n- `NIA_API_KEY` (required) - Your NIA API key\n- `NIA_API_URL` (optional) - API endpoint (defaults to https://apigcp.trynia.ai)\n\n## Pricing\n\nNIA offers simple, transparent pricing:\n\n- **Free Tier**: Limited usage, public repos only\n- **Pro**: Unlimited API calls, private repos, advanced features\n\nSee [https://trynia.ai/pricing](https://trynia.ai/pricing) for details.\n\n## Features\n\n- \ud83d\udd0d **Unified Search** - Search across code AND documentation seamlessly\n- \ud83d\udcda **Documentation Indexing** - Index any website or documentation\n- \ud83d\ude80 **Fast Indexing** - Index repositories and websites quickly\n- \ud83d\udd12 **Private Repos** - Support for private repositories (Pro)\n- \ud83d\udcca **Smart Understanding** - AI-powered code and content comprehension\n- \ud83c\udf10 **Works Everywhere** - Any MCP-compatible client\n\n## Troubleshooting\n\n### \"No API key provided\"\nMake sure `NIA_API_KEY` is set in your MCP client configuration.\n\n### \"Invalid API key\"\nCheck your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)\n\n### \"Rate limit exceeded\"\nYou've hit your monthly limit. Upgrade at [https://trynia.ai/billing](https://trynia.ai/billing)\n\n### Repository not indexing\nLarge repositories can take a few minutes. Use `check_repository_status` to monitor progress.\n\n## Support\n\n- Documentation: [https://docs.trynia.ai](https://docs.trynia.ai)\n- Discord: [https://discord.gg/BBSwUMrrfn](https://discord.gg/BBSwUMrrfn)\n- Email: support@trynia.ai\n\n## License\n\nMIT License - see LICENSE file for details.",
    "bugtrack_url": null,
    "license": null,
    "summary": "Nia Knowledge Agent",
    "version": "1.0.9",
    "project_urls": {
        "Documentation": "https://docs.trynia.ai",
        "Homepage": "https://trynia.ai"
    },
    "split_keywords": [
        "ai",
        " codebase",
        " mcp",
        " nia",
        " search"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "15a9239a03d532d2f849823be276200be8fdb4f2ec5431324dc5707899907789",
                "md5": "f027c9597e7183cbfbf8130a47ab6106",
                "sha256": "e7142cd28bcd470510e3363ded6d5b1b8c695598772d3df7269adc6d0aa68804"
            },
            "downloads": -1,
            "filename": "nia_mcp_server-1.0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f027c9597e7183cbfbf8130a47ab6106",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 42406,
            "upload_time": "2025-07-21T05:33:57",
            "upload_time_iso_8601": "2025-07-21T05:33:57.687176Z",
            "url": "https://files.pythonhosted.org/packages/15/a9/239a03d532d2f849823be276200be8fdb4f2ec5431324dc5707899907789/nia_mcp_server-1.0.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1500e30f9f509d7cb5775b480d4c417369327e2fe87de6329e816ecf468bb910",
                "md5": "7ff3e03d0e28281f5b3760ddbe55889b",
                "sha256": "724de8c9a58ed26bec9ebeb5a6f6b3b2f4031d6fbb3261bd451fb2e9c6917a08"
            },
            "downloads": -1,
            "filename": "nia_mcp_server-1.0.9.tar.gz",
            "has_sig": false,
            "md5_digest": "7ff3e03d0e28281f5b3760ddbe55889b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 36641,
            "upload_time": "2025-07-21T05:33:59",
            "upload_time_iso_8601": "2025-07-21T05:33:59.417459Z",
            "url": "https://files.pythonhosted.org/packages/15/00/e30f9f509d7cb5775b480d4c417369327e2fe87de6329e816ecf468bb910/nia_mcp_server-1.0.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-21 05:33:59",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "nia-mcp-server"
}
        
Elapsed time: 1.17290s