Pod

Yes, this is on purpose. Pod is built for agents, so the default page is plain HTML.
Human? View the normal website.
Agent? You probably prefer /mcp/serena-mcp-the-ide-for-your-agent/issues.md or /mcp/serena-mcp-the-ide-for-your-agent/issues.json, or Pod over MCP.

Reported issues for Serena MCP: the IDE for your agent

Pod holds 24 of 304 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Serena MCP: the IDE for your agent.

Most discussed

Serena MCP consumes all system memory (~30GB) causing Claude Code to freeze

Serena MCP consumes all system memory (~30GB) causing Claude Code to freeze

I have:

Read the thread · 2026-01-16 · closed · external user · 24 comments

Claude Code failed to connect Serena in Idea CE 2025.2 but works in VS Code

I've checked another issue and tried with MCP_TIMEOUT=60000 but it's not working, the MCP server is not started at all (no browser window open)

Steps to reproduce:

  1. Idea CE 2025.2, installed claude extention
  2. claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant --project $(pwd)
  3. in Idea, click the Claude icon, and /mcp to check the status, and it says failed. no further log can be found. (where can I find the startup lo

Read the thread · 2025-09-21 · closed · external user · 21 comments

Failed to connect in Claude code

I have:

Read the thread · 2025-08-18 · closed · external user · 43 comments

TypeScript Language Server doesn't work on Windows with Claude Code

  1. Install Serena MCP with the command: claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena-mcp-server --context ide-assistant --project Some/Path/To/The/Project
  2. Index the project with uvx --from git+https://github.com/oraios/serena index-project command
  3. Start Claude Code
  4. In the logs there are no messages after: `INFO 2025-07-27 13:50:44,822 [SerenaAgentExecutor_0] solidlsp.language_servers.common:_run_command:82 - Running command 'npm install --prefix

Read the thread · 2025-07-27 · closed · external user · 19 comments

serena read_file or find_symbol and other tool calls in claude code gets stuck

claude code uses the tools such as read file or find_symbol and then it gets stuck for many minutes.

Image

also the windows task manager shows a python process that I assume is related to serena engine which is constantly running with 20% of cpu.

it never errors out or times out and there is not much useful information in the serena dashboard logs:

INFO 2025-07-23 1

Read the thread · 2025-07-23 · closed · external user · 28 comments

Serena is failing to start

Environment:

WSL Claude Code - v1.0.35

Problem:

When starting MCP server, I am following the the guideline for MCP configuration:

 "serena": {
                "command": "/home/akamalov/.local/bin/uvx",
                "args": [
                    "--from",
                    "git+https://github.com/oraios/serena",
                    "serena-mcp-server"
                ]
        }

Unfortunately, MCP is failing to start:

![Image](https://github.com/user-attachments/ass

Read the thread · 2025-06-29 · closed · external user · 38 comments

running claude-code cli and serena issues

│ Serena MCP Server │ │ │ │ Status: ◯ connecting… │ │ Command: uvx │ │ Args: --from git+https://github.com/oraios/serena serena-mcp-server --context desktop-app

Read the thread · 2025-06-20 · closed · external user · 39 comments

Serena MCP breaks on only one specific project

Strangely this happens with only one project which uses a combination of Laravel 12 and Vue 3. When I try to add serena to other projects, it works just fine. FYI I am using WSL2 here. I follow the exact same instructions to add the mcp server but it only fails with one particular project. For the other projects, my browser window opens normally and I see the Serena dashboard, but if I try to start it with one specific project, I receive the following output (with Claude debug mode enabled) and

Read the thread · 2025-06-20 · closed · external user · 19 comments

Most recent

Compatibility: Handle deprecated ToolAnnotations.readOnlyHint in favor of read_only_hint

Description

In src/memo/server_write_coordinator.py, the middleware checks whether a tool is read-only by accessing getattr(annotations, "readOnlyHint", False). In recent versions of the MCP Python SDK / FastMCP (v2+), ToolAnnotations migrated to Python PEP8 naming conventions, renaming readOnlyHint to read_only_hint. Accessing the legacy readOnlyHint attribute triggers a FastMCPDeprecationWarning:

FastMCPDeprecationWarning: Accessing ToolAnnotations.readOnlyHint is dep

[Read the thread](https://github.com/oraios/serena/issues/1943) · 2026-08-26 · closed · external user · 0 comments

### Security Hardening: Implement local token-based authentication for JetBrains Plugin IPC

### Description
In `src/serena/jetbrains/jetbrains_plugin_client.py`, Serena communicates with the Serena JetBrains IDE plugin via unauthenticated local HTTP endpoints on `127.0.0.1` (over ports `27000-27020`).
While this communication is restricted to `localhost`, local unauthenticated HTTP services can potentially be exposed to local cross-protocol or cross-origin interactions (e.g. unauthorized local processes or browser-based CSRF/DNS rebinding attacks accessing IDE capabilities such as `/de

[Read the thread](https://github.com/oraios/serena/issues/1942) · 2026-08-26 · open · external user · 0 comments

### Unescaped CRLF / Potential Log Injection (CWE-117) in tool execution logging (`tools_base.py`)

### Description
In `src/serena/tools/tools_base.py`, the method `_log_tool_application` records incoming tool parameters to standard logger using string interpolation without neutralizing CRLF characters (`\r`, `\n`) or terminal control sequences.
If an untrusted or automated agent caller supplies multiline input strings containing control sequences, fake log entries can be injected into the log streams (log forging / CWE-117).
### Vulnerable Code Location
In [`src/serena/tools/tools_base.py`](h

[Read the thread](https://github.com/oraios/serena/issues/1941) · 2026-08-26 · open · external user · 1 comment

### Docs: TypeScript monorepos silently under-report cross-package find_referencing_symbols without tsconfig project references

## Setup

Serena 1.7.0, MCP client Claude Code, macOS 26.5 arm64. Language: TypeScript, `typescript-language-server` 5.1.3, workspace TypeScript 6.0.3. pnpm monorepo: 2 apps (Next.js, Expo) and 15 packages, 1406 tracked `.ts`/`.tsx` files.

**This is not a Serena bug** — it is tsserver behaviour Serena inherits. Filing it as a documentation request, because the failure is silent and hits what I suspect is a large share of Serena's TypeScript users.

## What happens

In a monorepo where packages 

[Read the thread](https://github.com/oraios/serena/issues/1939) · 2026-08-26 · open · external user · 0 comments

### read_only: true still advertises the editing tools in tools/list (14 advertised, 7 callable) although excluded_tools in the same project.yml does shrink the list

## Setup

Serena 1.7.0 (`uv tool install -p 3.13 serena-agent`), MCP client Claude Code, macOS 26.5 arm64, TypeScript project, context `claude-code`, started with `--project-from-cwd` so the project is known at startup.

## What happens

With `read_only: true` in `.serena/project.yml`, the editing tools are still **advertised** in `tools/list`. They are only refused when called.

Probed the server over stdio exactly as the MCP client starts it:

- `tools/list` → **14** tools, including `insert_a

[Read the thread](https://github.com/oraios/serena/issues/1938) · 2026-08-26 · open · external user · 0 comments

### Memory persistence is not explicit when the agent appears to record memories

# Memory persistence is not explicit when the agent appears to record memories

## Preconditions

- [x] I have made sure it's an actual issue, not a question (use [GitHub Discussions](https://github.com/oraios/serena/discussions) instead).
- [x] I have consulted the [user guide](https://oraios.github.io/serena/02-usage/) and verified that the issue cannot be resolved by adjusting configuration/following recommended workflows.
- [x] I have looked for similar issues and discussions, including clos

[Read the thread](https://github.com/oraios/serena/issues/1936) · 2026-08-26 · open · external user · 1 comment

### CVEs in docker image

Preconditions:

- [x] I have made sure it's an actual issue, not a question (use [GitHub Discussions](https://github.com/oraios/serena/discussions) instead).
- [x] I have consulted the [user guide](https://oraios.github.io/serena/02-usage/) and verified that the issue cannot be resolved by adjusting configuration/following recommended workflows.
- [x] I have looked for similar issues and discussions, including closed ones.

Issue details:

- [x] I have provided a meaningful title and description

[Read the thread](https://github.com/oraios/serena/issues/1934) · 2026-08-25 · open · external user · 2 comments

### Serena is incompatible with the "tool search" pattern

Preconditions:

- [X] I have made sure it's an actual issue, not a question (use [GitHub Discussions](https://github.com/oraios/serena/discussions) instead).
- [X] I have consulted the [user guide](https://oraios.github.io/serena/02-usage/) and verified that the issue cannot be resolved by adjusting configuration/following recommended workflows.
- [X] I have looked for similar issues and discussions, including closed ones.

Issue details:
References:
- [Cloudflare: Code Mode: give agents an enti

[Read the thread](https://github.com/oraios/serena/issues/1932) · 2026-08-25 · open · external user · 0 comments

### FindSymbolTool crashes on max_matches=0 due to unhandled AssertionError

In src/serena/tools/symbol_tools.py, FindSymbolTool.apply() validates the max_matches parameter using an assert statement: `assert max_matches != 0, "max_matches must be > 0 or equal to -1."`
If a client or model calls the tool with max_matches=0, an unhandled AssertionError is raised, causing the MCP server tool execution to crash.

Example input:

{ "name_path_pattern": "some_symbol", "max_matches": 0 }

Expected behavior: The tool should validate arguments gracefully (e.g. raise a V

[Read the thread](https://github.com/oraios/serena/issues/1924) · 2026-08-24 · closed · external user · 1 comment

### MCP spec conformance: 7 requirement(s) violated (via @hasmcp/mcp-spec-test)

We ran [@hasmcp/mcp-spec-test](https://github.com/hasmcp/mcp-spec-test), a black-box MCP protocol conformance suite, against `serena start-mcp-server`. The server handles normal handshakes and tool listing fine with a stock SDK client, but it does not respond at all (times out after 10s) to a couple of edge-case requests: an `initialize`/`server/discover` call that omits a protocol version, and a handshake that offers an explicitly unsupported version. Per the MCP spec, a version-less request sh

[Read the thread](https://github.com/oraios/serena/issues/1922) · 2026-08-24 · open · external user · 1 comment

### SerenaMCPFactory._sanitize_for_openai_tools drops items/enum when collapsing an Optional anyOf

Preconditions:

- [x] I have made sure it's an actual issue, not a question.
- [x] I have consulted the user guide and verified this is not a configuration issue.
- [x] I have looked for similar issues and discussions, including closed ones.

Issue details:

- [x] I have provided a meaningful title and description.
- [x] I have explained how the issue arose and added instructions to reproduce it.
- [x] I have added details on my setup below.

### Setup

- Serena: current main, `7fcbca7e`
- MCP c

[Read the thread](https://github.com/oraios/serena/issues/1906) · 2026-08-22 · closed · outside contributor · 1 comment

### CLI as an alternative to MCP

**Is your feature request related to a problem? Please describe.**

I want to use the Serena MCP functionality, but access it through a CLI.

**Describe the solution you'd like**

Same functionality exposed through MCP could also be exposed through CLI.

**Describe alternatives you've considered**

Use https://github.com/philschmid/mcp-cli as a wrapper layer

**Additional context**

Thanks :)

[Read the thread](https://github.com/oraios/serena/issues/1905) · 2026-08-21 · closed · external user · 3 comments

### Symbol tools return raw ValueError tracebacks for ignored paths and non-symbol files

## Description

Symbol tools (`find_symbol`, `get_symbols_overview`) raise raw `ValueError` tracebacks when invoked on paths that are ignored by the project ignore rules or on files the language server cannot extract symbols from (JSON/SQL/etc.). The agent-facing tool result contains the raw chained exception text instead of a clean, actionable error message.

## Frequency

From one week of real agent workload against a single repository (serena shared streamable-http server, TypeScript project)

[Read the thread](https://github.com/oraios/serena/issues/1891) · 2026-08-18 · open · external user · 2 comments

### initialize reports serverInfo.version of the installed mcp SDK (1.28.1), not Serena's version

## Description

The MCP `initialize` handshake reports a `serverInfo.version` that is the version of the installed `mcp` Python SDK, not Serena's own version.

- `initialize` result: `"serverInfo": {"name": "Serena", "version": "1.28.1", ...}`
- `get_current_config` from the same running server: `Serena version: 1.7.0`
- The installed `mcp` package version is exactly `1.28.1`, and `1.28.1` has never been a Serena release (latest is 1.7.0).

## Cause

In `serena/mcp.py` (`start_mcp_server`), the 

[Read the thread](https://github.com/oraios/serena/issues/1889) · 2026-08-18 · open · external user · 0 comments

### Feature: add DSH (DeepSeek Harness) as a serena-hooks client

**Is your feature request related to a problem? Please describe.**

Serena works with DSH (DeepSeek Harness, https://github.com/deepseek-ai/deepseek-harness) today via manual MCP config — registering the Serena MCP server through DSH's `@deepseek-ai/dsh-mcp-client` plugin (`~/.dsh/cordis.patch.yml`). However, `serena-hooks` does not support DSH as a `--client`, so none of the lifecycle hooks (`activate`, `remind`, `cleanup`, `auto-approve`) can be wired up for DSH sessions.

**Describe the solut

[Read the thread](https://github.com/oraios/serena/issues/1869) · 2026-08-14 · open · external user · 1 comment

### `jetbrains_launch_command` spawns one IDE per MCP session with no serialisation, so N concurrent sessions race a single IDE cold start and N-1 get a modal DirectoryLock$CannotActivateException

Preconditions:

- [x] I have made sure it's an actual issue, not a question.
- [x] I have consulted the user guide and verified that the issue cannot be resolved by adjusting configuration/following recommended workflows. (The only configuration lever is to unset `jetbrains_launch_command`, i.e. to turn the feature off — which is what I have done locally.)
- [x] I have looked for similar issues and discussions, including closed ones. Searched `jetbrains_launch_command`, `DirectoryLock`, `already

[Read the thread](https://github.com/oraios/serena/issues/1864) · 2026-08-13 · open · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/oraios/serena/issues).