ossinsight-mcp 0.1.0
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.
- package/README.md +94 -0
- package/dist/index.js +16727 -0
- package/dist/index.js.map +7 -0
- package/package.json +40 -0
package/README.md
ADDED
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
# ossinsight-mcp
|
|
2
|
+
|
|
3
|
+
An MCP server (stdio) built with `pnpm` for the OSS Insight Public API.
|
|
4
|
+
|
|
5
|
+
## Prerequisites
|
|
6
|
+
|
|
7
|
+
- Node.js 20+
|
|
8
|
+
- pnpm 9+
|
|
9
|
+
|
|
10
|
+
## Install
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
pnpm install
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
## Run
|
|
17
|
+
|
|
18
|
+
Development:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
pnpm dev
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Build bundle and start:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
pnpm build
|
|
28
|
+
pnpm start
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
`pnpm build` generates a single bundled file at `dist/index.js` using esbuild.
|
|
32
|
+
The bundle is generated with a Node shebang and executable permission, so it can be launched as a CLI binary (for `npx` / `bin` usage).
|
|
33
|
+
|
|
34
|
+
## Configure in Cursor
|
|
35
|
+
|
|
36
|
+
Add this server to your MCP config:
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
{
|
|
40
|
+
"mcpServers": {
|
|
41
|
+
"ossinsight": {
|
|
42
|
+
"command": "pnpm",
|
|
43
|
+
"args": ["start"],
|
|
44
|
+
"cwd": "/absolute/path/to/ossinsight-mcp"
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
For development mode, use:
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"mcpServers": {
|
|
55
|
+
"ossinsight": {
|
|
56
|
+
"command": "pnpm",
|
|
57
|
+
"args": ["dev"],
|
|
58
|
+
"cwd": "/absolute/path/to/ossinsight-mcp"
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Included MCP tools
|
|
65
|
+
|
|
66
|
+
- `list_collections`
|
|
67
|
+
- `list_hot_collections`
|
|
68
|
+
- `collection_ranking_by_issues`
|
|
69
|
+
- `collection_ranking_by_prs`
|
|
70
|
+
- `collection_ranking_by_stars`
|
|
71
|
+
- `list_collection_repositories`
|
|
72
|
+
- `list_trending_repos`
|
|
73
|
+
- `list_issue_creators`
|
|
74
|
+
- `issue_creators_countries`
|
|
75
|
+
- `repo_issue_creators_history`
|
|
76
|
+
- `list_pull_request_creators`
|
|
77
|
+
- `pull_request_creators_countries`
|
|
78
|
+
- `pull_request_creators_history`
|
|
79
|
+
- `pull_request_creators_organizations`
|
|
80
|
+
- `repo_stargazers_countries`
|
|
81
|
+
- `repo_stargazers_history`
|
|
82
|
+
- `repo_stargazers_organizations`
|
|
83
|
+
- `ossinsight_request` (generic GET endpoint wrapper)
|
|
84
|
+
|
|
85
|
+
## API reference
|
|
86
|
+
|
|
87
|
+
- Docs: https://ossinsight.io/docs/api
|
|
88
|
+
- Base URL: `https://api.ossinsight.io/v1`
|
|
89
|
+
- Public beta auth: no auth required (rate limited)
|
|
90
|
+
|
|
91
|
+
## Notes
|
|
92
|
+
|
|
93
|
+
- This server currently calls GET endpoints only.
|
|
94
|
+
- The `ossinsight_request` tool helps you quickly use new endpoints without code changes.
|