nia-mcp-server 1.0.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of nia-mcp-server might be problematic. Click here for more details.
- nia_mcp_server/__init__.py +5 -0
- nia_mcp_server/__main__.py +11 -0
- nia_mcp_server/api_client.py +477 -0
- nia_mcp_server/server.py +804 -0
- nia_mcp_server-1.0.0.dist-info/METADATA +200 -0
- nia_mcp_server-1.0.0.dist-info/RECORD +9 -0
- nia_mcp_server-1.0.0.dist-info/WHEEL +4 -0
- nia_mcp_server-1.0.0.dist-info/entry_points.txt +2 -0
- nia_mcp_server-1.0.0.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: nia-mcp-server
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: NIA Knowledge Agent - MCP server for intelligent codebase search
|
|
5
|
+
Project-URL: Homepage, https://trynia.ai
|
|
6
|
+
Project-URL: Documentation, https://docs.trynia.ai
|
|
7
|
+
Project-URL: Repository, https://github.com/trynia/nia-mcp-server
|
|
8
|
+
Project-URL: Issues, https://github.com/trynia/nia-mcp-server/issues
|
|
9
|
+
Author-email: NIA Team <support@trynia.ai>
|
|
10
|
+
License-Expression: MIT
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Keywords: ai,codebase,mcp,nia,search
|
|
13
|
+
Classifier: Development Status :: 4 - Beta
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
22
|
+
Requires-Python: >=3.8
|
|
23
|
+
Requires-Dist: httpx>=0.24.0
|
|
24
|
+
Requires-Dist: mcp>=0.1.0
|
|
25
|
+
Requires-Dist: pydantic>=2.0.0
|
|
26
|
+
Requires-Dist: python-dotenv>=1.0.0
|
|
27
|
+
Description-Content-Type: text/markdown
|
|
28
|
+
|
|
29
|
+
# NIA MCP Server
|
|
30
|
+
|
|
31
|
+
The NIA MCP Server enables AI assistants like Claude to search and understand your indexed codebases through the Model Context Protocol (MCP).
|
|
32
|
+
|
|
33
|
+
## Quick Start
|
|
34
|
+
|
|
35
|
+
### 1. Get your NIA API Key
|
|
36
|
+
|
|
37
|
+
Sign up and get your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)
|
|
38
|
+
|
|
39
|
+
### 2. Install via pip
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
pip install nia-mcp-server
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### 3. Configure with Claude Desktop
|
|
46
|
+
|
|
47
|
+
Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
|
|
48
|
+
|
|
49
|
+
```json
|
|
50
|
+
{
|
|
51
|
+
"mcpServers": {
|
|
52
|
+
"nia": {
|
|
53
|
+
"command": "nia-mcp-server",
|
|
54
|
+
"env": {
|
|
55
|
+
"NIA_API_KEY": "your-api-key-here"
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 4. Restart Claude Desktop
|
|
63
|
+
|
|
64
|
+
That's it! You can now ask Claude to index and search codebases.
|
|
65
|
+
|
|
66
|
+
## Usage Examples
|
|
67
|
+
|
|
68
|
+
### Index a repository
|
|
69
|
+
```
|
|
70
|
+
Claude, please index https://github.com/facebook/react
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Index documentation
|
|
74
|
+
```
|
|
75
|
+
Index the documentation at https://docs.python.org
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Search across everything
|
|
79
|
+
```
|
|
80
|
+
How does async/await work? Search both my code and documentation.
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Search only repositories
|
|
84
|
+
```
|
|
85
|
+
Find the authentication logic in my repositories
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Search only documentation
|
|
89
|
+
```
|
|
90
|
+
What are the best practices for error handling according to the docs?
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### List your resources
|
|
94
|
+
```
|
|
95
|
+
Show me all my indexed repositories and documentation
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Available Tools
|
|
99
|
+
|
|
100
|
+
### Repository Management
|
|
101
|
+
- **`index_repository`** - Index a GitHub repository
|
|
102
|
+
- **`list_repositories`** - List all indexed repositories
|
|
103
|
+
- **`check_repository_status`** - Check repository indexing progress
|
|
104
|
+
- **`delete_repository`** - Remove an indexed repository
|
|
105
|
+
|
|
106
|
+
### Documentation Management
|
|
107
|
+
- **`index_documentation`** - Index documentation or any website
|
|
108
|
+
- **`list_documentation`** - List all indexed documentation sources
|
|
109
|
+
- **`check_documentation_status`** - Check documentation indexing progress
|
|
110
|
+
- **`delete_documentation`** - Remove indexed documentation
|
|
111
|
+
|
|
112
|
+
### Unified Search
|
|
113
|
+
- **`search_codebase`** - Search across repositories and/or documentation
|
|
114
|
+
- `search_mode`: "repositories", "sources", or "unified" (default)
|
|
115
|
+
- Automatically searches all indexed content if not specified
|
|
116
|
+
|
|
117
|
+
## Other MCP Clients
|
|
118
|
+
|
|
119
|
+
### Continue.dev
|
|
120
|
+
|
|
121
|
+
Add to your `~/.continue/config.json`:
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{
|
|
125
|
+
"models": [...],
|
|
126
|
+
"mcpServers": [
|
|
127
|
+
{
|
|
128
|
+
"name": "nia",
|
|
129
|
+
"command": "nia-mcp-server",
|
|
130
|
+
"env": {
|
|
131
|
+
"NIA_API_KEY": "your-api-key-here"
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
]
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### VS Code Cline
|
|
139
|
+
|
|
140
|
+
Add to your Cline settings:
|
|
141
|
+
|
|
142
|
+
```json
|
|
143
|
+
{
|
|
144
|
+
"mcpServers": {
|
|
145
|
+
"nia": {
|
|
146
|
+
"command": "nia-mcp-server",
|
|
147
|
+
"env": {
|
|
148
|
+
"NIA_API_KEY": "your-api-key-here"
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
## Environment Variables
|
|
156
|
+
|
|
157
|
+
- `NIA_API_KEY` (required) - Your NIA API key
|
|
158
|
+
- `NIA_API_URL` (optional) - API endpoint (defaults to https://api.trynia.ai)
|
|
159
|
+
|
|
160
|
+
## Pricing
|
|
161
|
+
|
|
162
|
+
NIA offers simple, transparent pricing:
|
|
163
|
+
|
|
164
|
+
- **Free Tier**: Limited usage, public repos only
|
|
165
|
+
- **Pro**: Unlimited API calls, private repos, advanced features
|
|
166
|
+
|
|
167
|
+
See [https://trynia.ai/pricing](https://trynia.ai/pricing) for details.
|
|
168
|
+
|
|
169
|
+
## Features
|
|
170
|
+
|
|
171
|
+
- 🔍 **Unified Search** - Search across code AND documentation seamlessly
|
|
172
|
+
- 📚 **Documentation Indexing** - Index any website or documentation
|
|
173
|
+
- 🚀 **Fast Indexing** - Index repositories and websites quickly
|
|
174
|
+
- 🔒 **Private Repos** - Support for private repositories (Pro)
|
|
175
|
+
- 📊 **Smart Understanding** - AI-powered code and content comprehension
|
|
176
|
+
- 🌐 **Works Everywhere** - Any MCP-compatible client
|
|
177
|
+
|
|
178
|
+
## Troubleshooting
|
|
179
|
+
|
|
180
|
+
### "No API key provided"
|
|
181
|
+
Make sure `NIA_API_KEY` is set in your MCP client configuration.
|
|
182
|
+
|
|
183
|
+
### "Invalid API key"
|
|
184
|
+
Check your API key at [https://trynia.ai/api-keys](https://trynia.ai/api-keys)
|
|
185
|
+
|
|
186
|
+
### "Rate limit exceeded"
|
|
187
|
+
You've hit your monthly limit. Upgrade at [https://trynia.ai/billing](https://trynia.ai/billing)
|
|
188
|
+
|
|
189
|
+
### Repository not indexing
|
|
190
|
+
Large repositories can take a few minutes. Use `check_repository_status` to monitor progress.
|
|
191
|
+
|
|
192
|
+
## Support
|
|
193
|
+
|
|
194
|
+
- Documentation: [https://docs.trynia.ai](https://docs.trynia.ai)
|
|
195
|
+
- Discord: [https://discord.gg/trynia](https://discord.gg/trynia)
|
|
196
|
+
- Email: support@trynia.ai
|
|
197
|
+
|
|
198
|
+
## License
|
|
199
|
+
|
|
200
|
+
MIT License - see LICENSE file for details.
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
nia_mcp_server/__init__.py,sha256=KALmrtisZoSvqBXOARDBDCF8OCqvaxcIWGbYgvgcW64,84
|
|
2
|
+
nia_mcp_server/__main__.py,sha256=XY11ESL4hctu-BBgtPATFZyd1o-O7wE7y-UOSoNs-hw,152
|
|
3
|
+
nia_mcp_server/api_client.py,sha256=Ajz8Cd9zKpHMAVlujZ0boRlwwlIlqV2mL0IVy5kyaOM,18989
|
|
4
|
+
nia_mcp_server/server.py,sha256=YemqhzbVo05DZB4U0DfHXkA1MkRAVToJgqwuiqQDBQI,30016
|
|
5
|
+
nia_mcp_server-1.0.0.dist-info/METADATA,sha256=X94FgybQeGhvPR7VtsvZMaKW1pibeULU91KLFYPhLN4,5256
|
|
6
|
+
nia_mcp_server-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
|
|
7
|
+
nia_mcp_server-1.0.0.dist-info/entry_points.txt,sha256=V74FQEp48pfWxPCl7B9mihtqvIJNVjCSbRfCz4ww77I,64
|
|
8
|
+
nia_mcp_server-1.0.0.dist-info/licenses/LICENSE,sha256=5jUPBVkZEicxSAZ91jOO7i8zXEPAHS6M0w8SSf6DftI,1071
|
|
9
|
+
nia_mcp_server-1.0.0.dist-info/RECORD,,
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024 NIA (trynia.ai)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|