@reposkein/mcp 0.1.2 → 0.1.3

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.
Files changed (2) hide show
  1. package/README.md +12 -5
  2. package/package.json +31 -2
package/README.md CHANGED
@@ -1,12 +1,17 @@
1
+ <div align="center">
2
+ <img src="https://capsule-render.vercel.app/api?type=waving&color=0:070A12,45:2DD4BF,100:F2B84B&height=150&section=header&text=RepoSkein&fontColor=EAE7DC&fontSize=56&animation=fadeIn" width="100%" alt="RepoSkein" />
3
+ </div>
4
+
1
5
  # @reposkein/mcp
2
6
 
3
7
  **Give your AI coding agent a map of your codebase — instead of letting it grep and guess.**
4
8
 
5
- [![npm](https://img.shields.io/npm/v/@reposkein/mcp.svg?logo=npm)](https://www.npmjs.com/package/@reposkein/mcp)
6
- [![npm downloads](https://img.shields.io/npm/dm/@reposkein/mcp.svg)](https://www.npmjs.com/package/@reposkein/mcp)
7
- [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/reposkein/reposkein/blob/main/LICENSE)
8
- [![MCP](https://img.shields.io/badge/MCP-server-7c3aed.svg)](https://modelcontextprotocol.io)
9
+ [![npm](https://img.shields.io/npm/v/@reposkein/mcp?style=for-the-badge&logo=npm&logoColor=EAE7DC&label=npm&labelColor=070A12&color=F2B84B)](https://www.npmjs.com/package/@reposkein/mcp)
10
+ [![downloads](https://img.shields.io/npm/dm/@reposkein/mcp?style=for-the-badge&label=downloads&labelColor=070A12&color=2DD4BF)](https://www.npmjs.com/package/@reposkein/mcp)
11
+ [![License](https://img.shields.io/badge/license-Apache_2.0-F2B84B?style=for-the-badge&labelColor=070A12)](https://github.com/reposkein/reposkein/blob/main/LICENSE)
12
+ [![MCP](https://img.shields.io/badge/MCP-server-2DD4BF?style=for-the-badge&labelColor=070A12)](https://modelcontextprotocol.io)
9
13
  [![skills.sh](https://skills.sh/b/reposkein/reposkein)](https://skills.sh/reposkein/reposkein)
14
+ [![mcpservers.org](https://img.shields.io/badge/mcpservers.org-listed-2DD4BF?style=for-the-badge&labelColor=070A12)](https://mcpservers.org/servers/reposkein/reposkein)
10
15
  [![mcpservers.org](https://img.shields.io/badge/mcpservers.org-listed-1f6feb.svg)](https://mcpservers.org/servers/reposkein/reposkein)
11
16
 
12
17
  This is the [Model Context Protocol](https://modelcontextprotocol.io) server for [**RepoSkein**](https://github.com/reposkein/reposkein) — a deterministic **code graph** (functions, classes, imports, call edges) built from your repo with [Tree-sitter](https://tree-sitter.github.io/) and served to any MCP-capable agent (Claude Code, Cursor, Codex, …). Your agent navigates structure instead of guessing, and writes short summaries onto the graph as it learns — versioned in git as shared team memory.
@@ -15,6 +20,8 @@ This is the [Model Context Protocol](https://modelcontextprotocol.io) server for
15
20
  - 🔒 **Deterministic** — same code → byte-identical graph. No LLM in the construction path.
16
21
  - 🌐 **7 languages** — Python, TypeScript, JavaScript, Rust, Go, Java, C#.
17
22
 
23
+ **Contents:** [Get started](#get-started-30-seconds) · [Tools](#tools) · [How your agent uses it](#how-your-agent-uses-it) · [Configuration](#configuration) · [Embeddings](#optional-semantic-embeddings) · [Learn more](#learn-more)
24
+
18
25
  ## Get started (≈30 seconds)
19
26
 
20
27
  In the repo you want your agent to understand:
@@ -118,7 +125,7 @@ REPOSKEIN_EMBED_MODEL=voyage-4-nano # or any model your local server serves
118
125
  REPOSKEIN_EMBED_DIMS=1024
119
126
  ```
120
127
 
121
- Point this at any OpenAI-compatible local embedding server (e.g. running `voyage-4-nano` from [huggingface.co/voyageai/voyage-4-nano](https://huggingface.co/voyageai/voyage-4-nano), sentence-transformers, or similar). All text stays on your machine.
128
+ Point this at any OpenAI-compatible local embedding server. Two easy options: **Ollama** (`ollama pull nomic-embed-text`, URL `http://127.0.0.1:11434/v1/embeddings`, dims 768), or RepoSkein's **one-command `voyage-4-nano` server** — [`embed-server/`](https://github.com/reposkein/reposkein/tree/main/embed-server) (`docker compose up -d`). All text stays on your machine.
122
129
 
123
130
  **How it works:** vectors are cached in `.reposkein/local/embeddings/` (gitignored — never committed, never required). The cache is invalidated per-node when the document content changes. On any embedding error, `semantic_find` silently falls back to the lexical result. Enabling embeddings never changes the committed graph.
124
131
 
package/package.json CHANGED
@@ -1,7 +1,36 @@
1
1
  {
2
2
  "name": "@reposkein/mcp",
3
- "version": "0.1.2",
4
- "description": "RepoSkein MCP server",
3
+ "version": "0.1.3",
4
+ "description": "Deterministic code-graph (GraphRAG) MCP server — give your AI agent callers/callees, change-impact, and semantic search over your repo instead of grep. 7 languages, zero-infra, git-native.",
5
+ "keywords": [
6
+ "mcp",
7
+ "model-context-protocol",
8
+ "llm",
9
+ "ai-agents",
10
+ "code-graph",
11
+ "graphrag",
12
+ "rag",
13
+ "tree-sitter",
14
+ "static-analysis",
15
+ "code-intelligence",
16
+ "code-navigation",
17
+ "claude",
18
+ "claude-code",
19
+ "cursor",
20
+ "codex",
21
+ "developer-tools",
22
+ "reposkein"
23
+ ],
24
+ "homepage": "https://github.com/reposkein/reposkein#readme",
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "git+https://github.com/reposkein/reposkein.git",
28
+ "directory": "mcp"
29
+ },
30
+ "bugs": {
31
+ "url": "https://github.com/reposkein/reposkein/issues"
32
+ },
33
+ "author": "RepoSkein",
5
34
  "license": "Apache-2.0",
6
35
  "type": "module",
7
36
  "bin": {